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Preface 


Audience 

This manual provides reference material about the VAXmate workstation. It 
covers all programmable components, the firmware, and several MS-DOS re¬ 
lated environments. The material and its presentation are directed to expe¬ 
rienced programmers or software designers. 

Manual Organization 

This manual is divided into four parts and appendixes: 

• Chapter 1 provides an overview of the VAXmate workstation and optional 
equipment. 

• Chapters 2 through 13 introduce the VAXmate workstation 
programmable hardware devices. Each chapter discusses a single hard¬ 
ware programming task, such as video input/output (I/O), external inter¬ 
rupt processing, or serial communications and includes the following 
information: 

- A brief device description 

- A list of additional references 

- A description of the programmable hardware registers 

- A programming example 

- A discussion of the example 

The examples are written in the C programming language to reduce the 
size of the examples and focus on the task rather than the detail required 
by the language. 

• Chapter 14 describes the power-up diagnostics and system startup. 

• Chapter 15 describes the read-only memory basic input/output system 
(ROM BIOS). 

• The appendixes contain additional information, including a bibliography of 
other useful publications. 
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Terminology 

The following terms are used throughout this manual and are defined as 
follows: 


Term 

Definition 

Industry-standard 

The computer industry recognizes two open architectures 
as industry standards, the IBM PC AT bus structure and 
the Microsoft disk operating system (MS-DOS). Moreover, 
supporting MS-DOS requires a defined set of ROM BIOS 
services. The term industry-standard refers to compatibil¬ 
ity with these architectures. 

Reserved 

Available 

Unassigned 

To avoid confusion and incompatibility, the use of certain 
items such as memory space, I/O space, interrupt vectors, 
and ROM BIOS parameters or return values must be 
clearly defined. These three categories define those items 
that do not have a specific use. 


Reserved In future hardware or software releases, 

DIGITAL may define a specific use for this 
item. Hardware or software applications 
that use this item may not work with 
future releases. 


Available Hardware or software applications can use 

this item. DIGITAL has defined the spe¬ 
cific use of this item as available for 
applications. 


Unassigned Hardware or software applications can use 

this item. However, there remains some 
risk that DIGITAL may define a specific 
use for this item. 
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Federal Communications Commission 
Radio Frequency Interference 

Class A Computing Devices 

This equipment generates, uses, and may emit radio frequency energy. The 
equipment has been tested and found to comply with the limits for a Class A 
computing device pursuant to Sub-part J of Part 15 of FCC Rules, which are 
designed to provide reasonable protection against such radio frequency interfer¬ 
ence when operated in a commercial environment. Operation of this equipment 
in a residential area may cause interference in which case the user at his own 
expense may be required to take measures to correct the interference. 

If this equipment does cause interference to radio or television reception, which 
can be determined by turning the equipment off and on, the user is encouraged 
to try to correct the interference by one or more of the following methods: 

• re-orient the receiving antenna 

• relocate the computer with respect to the receiver 

• move the computer away from the receiver 

• plug the computer into a different outlet so that computer and receiver 
are on different branch circuits. 

If necessary, the user should consult the dealer or an experienced radio 
and television technician for additional suggestions. The user may find the 
booklet, How to Identify and Resolve Radio/TV Interference Problems , 
prepared by the Federal Communications Commission helpful. This booklet is 
available from the U.S. Government Printing Office, Washington, DC 20402, 
Stock No. 004-000-00398-5. 

NOTE 

Shielded cables are provided for use with this device. Should any 
cables be replaced or added for any reason, these cables should 
be the same as, or with higher shielding capabilities, than those 
provided by Digital Equipment Corporation. 
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Chapter 1 

VAXmate Workstation Overview 


This chapter describes the VAXmate workstations physical appearance, base 
configuration, optional components, and the logical relationship of the 
components. 

The VAXmate workstation is a high-performance, standalone, desktop personal 
computer that executes industry-standard software. The integral Ethernet inter¬ 
face allows the VAXmate workstation to communicate on a network. The hard 
disk storage, provided in the optional expansion box, allows the VAXmate 
workstation to be a server on a network. 

Base System 

In the base configuration, the VAXmate workstation has three units: 

• System unit 

• Keyboard 

• Mouse 

Figure 1-1 shows a base configuration workstation. 


VAXmate Workstation Overview 1-1 



Figure 1-1 Base Configuration Workstation 

In the base configuration, the system unit contains the following major 
components: 

• 80286 microprocessor 

• One megabyte of dynamic random-access memory (DRAM) 

• Video monitor and controller 

• Diskette drive and controller 

• Ethernet controller 

• Keyboard interface controller 

• Event timer 

• Real time clock and calendar 

• Serial communications port 

• Serial printer port 

• Serial mouse port 

• Speaker 

• Power supply 
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Optional Components 

The workstation provides for the following optional components: 

• An expansion box, part number RCD31-EA, that attaches to the bottom 
of the system unit. Figure 1-2 shows the system unit with the expansion 
box attached. The expansion box contains an additional power supply, a 
battery, a 20 megabyte hard disk drive and controller, and two industry- 
standard expansion slots. 

• An 80287 coprocessor, part number FP287, that installs in the system 
unit. Figure 1-3 shows the 80287 coprocessor. 

• A two megabyte DRAM module, part number PC50X-AA, that installs in 
the system unit. Figure 1-4 shows the two megabyte DRAM module. 

• A modem module, part number PC50X-MA, that installs in the system 
unit. Figure 1-5 shows the modem module. 



Figure 1-2 Workstation With Installed Expansion Box 
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Figure 1-3 Optional 80287 Coprocessor 
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Figure 1-6 shows the relationship of the workstation components. The battery 
is present only when an expansion box is installed. 




Figure 1-6 Block Diagram of Workstation Components 
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Chapter 2 
VAXmate Microprocessor 


Overview 

The VAXmate microprocessor is an Intel 80286 central processing unit (CPU). 
The CPU is a high-performance, 8 MHz microprocessor with a 16-bit external 
data path and a 24-bit address path. The CPU provides two modes of opera¬ 
tion, real address mode and protected virtual address mode. 

Real Address Mode 

On powerup, the CPU operates in real address mode. In real address mode, the 
80286 CPU behaves as though it is a fast 8086 CPU. It is limited to the 1 
Mbyte address range of the 8086 CPU. In real address mode, the ROM is ac¬ 
cessed in the address range 0F0000H-0FFFFFH. 

Protected Virtual Address Mode 

In protected virtual address mode, the 80286 CPU can access 16 Mbytes of 
physical memory and 1 gigabyte of virtual memory. 

The ROM is redundantly mapped to two physical address ranges, 0F0000H- 
0FFFFFH and FF0000H-FFFFFFH. Therefore, in protected virtual address 
mode, the 80286 CPU can access the ROM at either physical address range. 
However, the majority of the ROM BIOS code is not valid in protected virtual 
address mode. 

The CPU uses the keyboard interface controller or a double exception fault to 
reset to real address mode from protected virtual address mode. The keyboard 
interface controller is discussed in Chapter 8. 
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Coprocessor 

The optional coprocessor for the VAXmate workstation is an Intel 80287 proc¬ 
essor extension chip. It is a high-performance, numeric processor that extends 
the CPU data types to include floating-point, extended-integer, and binary- 
coded decimal (BCD). 

Additional Sources of Information 

The following Intel Corporation documents provide additional information on 
the CPU and coprocessor: 

• Introduction to the iAPX 286 (Publication Number 210308) 

• iAPX 286 Hardware Reference Manual (Publication Number 210760) 

• iAPX 286 Programmer's Reference Manual (Publication Number 210498) 

• Microsystem Components Handbook (Publication Number 230843) 
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Memory Map 

The base configuration workstation has 1 Mbyte of RAM and 64 Kbytes of 
ROM. An optional memory module can be added without an expansion box. 

Table 2-1 describes the VAXmate workstation’s physical memory map. The 1 
Mbyte of RAM is divided into three, noncontiguous blocks. In Table 2-1, these 
blocks are labeled BLOCK1, BLOCK2, and BLOCK3. 

Table 2-1 Physical Memory Map 


From 

To 

Size 

(Bytes) 

Description 

000000H 

09FFFFH 

640K 

System RAM (BLOCK1) 

0A0000H 

OAFFFFH 

64K 

Reserved 

OBOOOOH 

OBFFFFH 

64K 

Video RAM 




During video mode setup, the video 
RAM is dynamically mapped. Only 
the video RAM required by the cur¬ 
rent video mode is accessible. 

0C0000H 

OCFFFFH 

64K 

Available for options with expansion 
ROM 

0D0000H 

OEFFFFH 

128K 

DIGITAL private RAM (BLOCK2) 

0F0000H 

OFFFFFH 

64K 

System ROM 

100000H 

EFFFFFH 

14336K 

Optional RAM space 

F00000H 

F1FFFFH 

128K 

Reserved RAM space 

F20000H 

F5FFFFH 

256K 

DIGITAL private RAM (BLOCK3) 

F60000H 

F7FFFFH 

128K 

Reserved RAM space 

F80000H 

FEFFFFH 

448K 

Reserved ROM space 

FF0000H 

FFFFFFH 

64K 

System ROM (redundantly mapped 
from 0F0000H) 
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Input/Output Address Map 

Table 2-2 describes the VAXmate workstation’s I/O address map. Many of the 
I/O ports have an industry-standard assignment. Recognition of that assign¬ 
ment does not indicate that the device is present in the workstation. 

Table 2-2 Input/Output Address Map 


From 

To 

Device 

Description 

0000H 

001FH 

8237A-5 

DMA controller 

0020H 

003 FH 

8259A 

Interrupt controller #1 

0040H 

005FH 

8254-2 

Timer 

0060H 

006FH 

8042 

Keyboard interface controller 

0070H 



Bit 7 controls the NMI mask register 

0070H 

0077H 

MC146818 

Real-time clock and CMOS RAM 

0078H 

007FH 


Reserved 

0080H 

009FH 

74LS670 

DMA page registers 

00A0H 

OOBFH 

8259A 

Interrupt controller #2 

OOCOH 

OODFH 


Reserved 

OOEOH 

OOEFH 


Unassigned 

OOFOH 



Clear math coprocessor busy 

00F1H 



Reset math coprocessor 

00F2H 

00F7H 


Unassigned 

00F8H 

OOFFH 

80287 

Math coprocessor 

0100H 

01EFH 


Unassigned 

01F0H 

01F8H 

WD2010 

Hard disk controller 

01F9H 

01FFH 


Unassigned 

0200H 

0207H 


Game port I/O 

0208H 

0277H 


Unassigned 

0278H 

027FH 


Parallel printer port #2 

0280H 

02F7H 


Unassigned 

02F8H 

02FFH 

8250 

Serial port #2 (Integral modem option) 
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Table 2-2 Input/Output Address Map (cont.) 


From 

To 

Device 

0300H 

031FH 


0320H 

035FH 


0360H 

036FH 


0370H 

0377H 


0378H 

037FH 


0380H 

038FH 


0390H 

039FH 


03A0H 

03AFH 


03B0H 

03BFH 


03C0H 

03CFH 


03D0H 

03DFH 

6845 

03E0H 

03EFH 


03F0H 

03F5H 

PD765A 

03F6H 

03F7H 


03F8H 

03FFH 

8250 

0400H 

OBFFH 


OCOOH 

0C1FH 


0C20H 

0C3FH 


0C40H 

0C5FH 

2661 

0C60H 

0C80H 

0C7FH 




0C81H 

0C9FH 


OCAOH 

0CA7H 

8250 

0CA8H 

ODFFH 


0E00H 

FFFFH 



Description 

Reserved 

Unassigned 

Reserved 

Unassigned 

Parallel printer port #1 

Reserved 

Unassigned 

Reserved 

Reserved 

Reserved 

Graphics video controller 

Unassigned 

Diskette controller 

Hard disk and diskette controllers 

Serial port #1 

Unassigned * 

System CSR 1 
Ethernet ROM 

Universal Asynchronous Receiver/ 
Transmitter (UART) for mouse port 

Network Controller and Interface 

Special purpose register 

Reserved 

Integral serial printer port 

Reserved 

Unassigned * 


* Industry-standard, processor-board, I/O ports in the address range 0000H- 
OOFFH respond to these I/O addresses. Therefore, I/O to the expansion 
box in this address range is undefined. 
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Interrupt Vector Map 

Table 2-3 shows the VAXmate workstation’s interrupts. The four columns in 
Table 2-3 provide the following information: 

• The interrupt column identifies the interrupt number in hexadecimal. 

• The type column is interpreted as follows: 

- The letter E indicates a processor exception interrupt. 

- The letter H indicates a hardware interrupt. 

- The letter S indicates a software interrupt. 

- The letter P indicates that the interrupt vector space contains a 
pointer to a parameter table or an application routine. 

- The letter N indicates that the vector has no assignment. 

• The description column identities the specific assignment of the interrupt 
vector. 

• The service column indicates whether or not the ROM BIOS services the 
interrupt. During system startup, interrupt vectors that are not serviced 
by the ROM BIOS are initialized to point to an interrupt return (IRET) 
instruction, indicated by IRET. For information on ROM BIOS-serviced 
software interrupts, see Chapter 15. 
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Table 2-3 Interrupt Vector Map 


Interrupt 

Type 

Description 

Service 

00H 

E 

Divide by zero 

IRET 

01H 

E 

Single step 

IRET 

02H 

H 

NMI 

ROM BIOS 

03H 

S 

Breakpoint (Used by DEBUG) 

IRET 

04H 

E 

Overflow 

IRET 

05H 

S 

Print Screen function 

ROM BIOS 

06H-07H 

N 

Reserved 

IRET 

08H 

H 

Timer interrupt service (IRQO) 

ROM BIOS 

09H 

H 

Keyboard interrupt service (IRQ1) 

ROM BIOS 

OAH 

H 

Reserved (IRQ2 interrupt from controller #2) 

IRET 

OBH 

H 

Serial port #2 (Asynchronous) (modem 
option) (IRQ3) 

IRET 

OCH 

H 

Serial port ft 1 (Asynchronous) (IRQ4) 

ROM BIOS 

ODH 

H 

Unassigned (IRQ5) 

IRET 

OEH 

H 

Diskette interrupt service (IRQ6) 

ROM BIOS 

OFH 

H 

Parallel printer port #1 (IRQ7) 

IRET 

10H 

S 

Video I/O 

ROM BIOS 

11H 

S 

Return configuration 

ROM BIOS 

12H 

S 

Return memory size 

ROM BIOS 

13H 

S 

Diskette and hard disk I/O 

ROM BIOS 

14H 

S 

Asynchronous communications I/O 

ROM BIOS 

15H 

S 

Extended ROM BIOS functions 

ROM BIOS 

16H 

S 

Keyboard I/O 

ROM BIOS 

17H 

S 

Printer Output 

ROM BIOS 

18H 

S 

Invoke network boot/Maintenance Operation 
Protocol (MOP) 

ROM BIOS 

19H 

S 

Bootstrap 

ROM BIOS 
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Table 2-3 Interrupt Vector Map (cont.) 


Interrupt 

Type 

Description 

Service 

1AH 

S 

Time of day 

ROM BIOS 

1BH 

P 

Keyboard BREAK vector 

IRET 

1CH 

P 

Timer tick vector 

IRET 

1DH 

P 

Video parameter table 

ROM BIOS 

1EH 

P 

Diskette parameter table 

ROM BIOS 

1FH 

P 

Graphics character table (Character codes 
80H-FFH) 

ROM BIOS 

20H-3FH 

S 

Reserved for MS-DOS 

IRET 

40H 

P 

INT 13H redirect when hard disk in use 

ROM BIOS 

41H 

P 

Parameter table pointer for hard disk 0 

ROM BIOS 

42H-45H 

N 

Reserved 

IRET 

46H 

P 

Parameter table pointer for hard disk 1 

ROM BIOS 

47H-5FH 

N 

Reserved 

IRET 

60H-67H 

N 

Available for application or user program 
interrupts 

IRET 

68H-6FH 

N 

Reserved for DECnet software 

IRET 

70H 

H 

Real time clock interrupt (IRQ8) 

ROM BIOS 

71H 

H 

Redirect to interrupt OAH - Old IRQ2 
(IRQ9) 

IRET 

72H 

H 

Ethernet controller (IRQ10) 

ROM BIOS 

73H 

H 

Serial printer port (IRQ11) 

ROM BIOS 

74H 

H 

Mouse port (IRQ12) 

IRET 

75H 

H 

80287 error (IRQ13> 

ROM BIOS 

76H 

H 

Hard disk controller (IRQ14) 

ROM BIOS 

77H 

H 

Unassigned (IRQ15) 

IRET 

78H-7FH 

N 

Unassigned 

IRET 

80H-F0H 

N 

Reserved 

IRET 

F1H-FFH 

N 

Unassigned 
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Bus Timing and Structure 

The 8 MHz clock rate results in a 125 ns processor cycle. Normal operation of 
the 80286 CPU requires two processor cycles. With zero wait states, a read or 
write cycle requires 250 ns. 

There are three data bus structures: 

• A 16-bit local bus 

• An 8-bit expansion bus 

• A 16-bit expansion bus 


16-Bit Local Bus 

The local bus connects the CPU to on-board memory and on-board peripherals. 
One wait state is added to local bus memory transfers, resulting in a 375 ns 
bus cycle. Two wait states are added to local bus input/output (I/O) transfers, 
resulting in a 500 ns bus cycle. 

The RAM access time is 150 ns. The ROM access time is 250 ns. 

NOTE 

In assembly language programming, directing two or more con¬ 
tiguous I/O instructions at the same device may not provide 
enough time for the device to respond. This is possible because 
peripheral devices respond more slowly than the 80286 proces¬ 
sor executes. A jump instruction consumes processor cycles and 
clears the processor pre-fetch queue. Thus, jumps to successive 
I/O instructions provide the required response time. The C lan¬ 
guage I/O functions, commonly named in() and out() or inp() and 
outsO, provide enough response time because they contain suf¬ 
ficient overhead in the calling sequence. 


16-Bit Expansion Bus 

The 16-bit expansion bus supports word transfers to memory and I/O. One wait 
state is automatically added, resulting in a 375 ns bus cycle. 

8-Bit Expansion Bus 

The 8-bit expansion bus supports byte and word transfers to memory and I/O. 
Word transfers are controlled by hardware, which issues two sequential byte 
transfers (low byte first and high byte second). Table 2-4 describes the bus 
cycle times for all transfer types on the 8-bit expansion bus. 
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Table 2-4 8-Bit Expansion Bus Transfer Times 


Type 

Size 

Time 

Wait States 

Memory 

Byte 

750 ns 

4 

Memory 

Word (two, 8-bit transfers) 

1500 ns 

8 

I/O 

Byte 

1125 ns 

7 

I/O 

Word (two, 8-bit transfers) 

2250 ns 

14 


Expansion Box Technical Specifications 

The VAXmate expansion box provides two expansion module slots. Each slot 
accommodates a single expansion module. If a mother-daughter board is used 
in one of the slots, then both slot areas will be used and it will not be possible 
to add a second module. Table 2-5 shows the amperage (current) and wattage 
values available for each slot. Each slot has an 8-bit and a 16-bit bus connector. 
Figure 2-1 shows the pin numbers and signal names for the 8-bit and 16-bit 
bus connector. 


Table 2-5 Expansion Slot Power Ratings 



+5.1V 

+12.1V 

-12.0V 

-5.0V 

Watts 


1.300 

0.100 

0.100 

0.100 



1.300 

0.100 

0.100 

0.100 

9.540 


Expansion Box Operating Ranges 

Ambient Operating Temperature: 15 C (59 F) to 32 C (90 F) 
Relative Humidity: 8% to 80% 
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8-Bit Bus Connector 


16-Bit Bus Connector 


GROUND B1 A1 I/O CBK L 

RESET H B2 A2 SD7 H 

+5V B3 A3 SD6 H 

IRQ9 H B4 A4 SD5 H 

-5V B5 A5 SD4 B 

DRQ2 H B6 A6 SD3 B 

-12V B7 A7 SD2 B 

OVS L B8 A8 SD1 B 

+12V B9 A9 SDO B 

GROUND BIO A10 I/O RDY B 

MEMV L Bll All AEN B 

MEMR L B12 A12 SA19 B 

IOV L B13 A13 SA18 B 

IOR L B14 A14 SA17 B 

DACK3 L B15 A15 SA16 B 

DRQ3 B B16 A16 SA15 B 

DACK1 L B17 A17 SA14 B 

DRQ1 B B18 A18 SA13 B 

REPRESS L B19 A19 SA12 B 

CLOCK B B20 A20 SA11 B 

IRQ7 B B21 A21 SAIO B 

IRQ6 B B22 A22 SA9 B 

IRQ5 B B23 A23 SA8 B 

IRQ4 B B24 A24 SA7 B 

IRQ3 B B25 A25 SA6 B 

DACK2 L B26 A26 SA5 B 

T/C B B27 A27 SA4 B 

ALE B B28 A28 SA3 B 

+5V B29 A29 SA2 B 

OSC B B30 A30 SA1 B 

GROUND B31 A31 SAO B 


Figure 2-1 8-Bit and 


MEM16 L 

D1 

Cl 

SBBE 

L 

1/016 L 

D2 

C2 

UA23 

H 

IRQ10 B 

D3 

C3 

UA22 

H 

IRQ11 B 

D4 

C4 

UA21 

H 

IRQ12 B 

D5 

C5 

UA20 

H 

IRQ15 B 

D6 

C6 

UA19 

H 

IRQ14 B 

D7 

C7 

UA18 

H 

DACKO L 

D8 

C8 

UA17 

H 

DRQO B 

D9 

C9 

EMEMR L 

DACK5 L 

** DIO 

CIO 

EMEMV L 

DRQ5 B 

** Dll 

Cll 

SD08 

H 

DACK6 L 

** D12 

C12 

SD09 

H 

DRQ6 B 

** D13 

C13 

SD10 

H 

DACK7 L 

** D14 

C14 

SD11 

H 

DRQ7 B 

** D15 

C15 

SD12 

H 

+5V 

D16 

C16 

SD13 

H 

MASTER L D17 

C17 

SD14 

H 

GROUND 

D18 

C18 

SD15 

H 


** Not Implemented 


16-Bit Bus Connectors 
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Chapter 3 
Interrupt Controllers 


Overview 

The VAXmate 80286 central processing unit (CPU) has two interrupt input 
lines, the Non-Maskable Interrupt (NMI) and the Interrupt Request (INTR). 
When these hardware inputs are active, the CPU suspends execution of the 
current program and begins execution of an interrupt handler. An interrupt 
handler is a program or program segment that responds to a specific event. 
This allows an immediate response to asynchronous external events and the 
segregation of program responsibility for handling those events. 

The interrupt input lines are assigned to different classes of events. The NMI 
is dedicated to two catastrophic events, memory parity errors and I/O bus 
errors. The INTR is assigned all other external interrupt sources, such as 
diskette and hard disk controllers, serial and parallel ports, and clocks. The 
reason for this division is the way the CPU implements the two interrupts: 

• The NMI has a higher priority than the INTR. 

• The CPU has no way to disable the NMI input. 

• The CPU provides handshaking protocol during INTR processing, but not 
during NMI processing. 

• The NMI generates only one interrupt vector, which is fixed. 

Because the CPU does not provide handshaking during NMI processing, the 
CPU cannot communicate with an interrupt controller. Therefore, the NMI 
sources are connected directly to the NMI input. To determine the source of 
the interrupt, the NMI interrupt handler must read the status output of the 
sources. 
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The INTR input is buffered by two, 8259A interrupt controllers. The interrupt 
controllers reduce the CPU interrupt processing overhead in the following 
ways: 

• They resolve the priority of simultaneous or overlapping interrupts. 

• They concentrate multiple interrupts into one source. 

• They provide the vector number of the interrupt handler. 

Each interrupt controller is capable of handling eight interrupt requests. The 
16 inputs are labeled IRQ0-IRQ15. Controller 1 buffers IRQ0-IRQ7 and control¬ 
ler 2 buffers IRQ8-IRQ15. Although they are physically identical, the interrupt 
controllers have a master/slave relationship. The output of controller 2 (the 
slave) is connected to the IRQ2 input of controller 1 (the master). The output 
of the master is connected to the INTR input of the CPU. Table 3-1 shows all 
of the IRQ inputs. 


Table 3-1 Interrupt Request Lines 


Priority 

Controller 
#1 MASTER 

Controller Source 

n SLAVE 

1 


IRQO 


Event timer output 0 

2 


IRQ1 


Keyboard controller 

3 


IRQ2 


Slave interrupt controller 


3.1 


IRQ8 

Real-time clock 


3.2 


IRQ9 

Software redirection to IRQ2 


3.3 


IRQ10 

LANCE (Ethernet) 


3.4 


IRQ11 

Serial printer port 


3.5 


IRQ12 

Mouse port 


3.6 


IRQ13 

Coprocessor error 


3.7 


IRQ14 

Hard disk drive controller 


3.8 


IRQ15 

Available, 16-bit bus 

4 


IRQ3 


Reserved, integral modem option 

5 


IRQ4 


Asynchronous communications port 

6 


IRQ5 


Available, 8-bit bus 

7 


IRQ6 


Diskette drive controller 

8 


IRQ7 


Available, 8-bit bus 
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Additional Source of Information 

The following Intel Corporation document provides additional information: 

• Microsystem Components Handbook (Publication Number 230843) 

Read/Write Control 

The 8259A interrupt controller has the following registers: 

Initialization Command Words (ICW) - There are four initialization com¬ 
mand words (ICW1-ICW4). They establish the operating conditions of the 
interrupt controller and are written only during system initialization. 

Operation Command Words (OCW) - There are three operational command 
words (OCW1-OCW3). These registers select access to internal controller 
registers and control the run-time aspects of the interrupt controller. 

Interrupt Mask Register (IMR) - The IMR selectively enables and disables 
the interrupt controller’s interrupt input lines. In this manual, IMR refers to 
the physical register and OCW1 refers to the command to read or write the 
interrupt mask register. 

Interrupt Request Register (IRR) - Following a CPU interrupt acknowledge, 
each bit in the IRR reflects the state of the corresponding interrupt input. 

In-Service Register (ISR) - The ISR register indicates the interrupt input 
lines that the CPU is currently servicing. 

Poll data - The poll data indicates whether any enabled interrupt inputs are 
active. If any enabled interrupt inputs are active, it also contains the inter¬ 
rupt input number of the highest priority input requesting service. 

Although the 8259A interrupt controller has many registers, it has only two 
input/output (I/O) ports. Table 3-2 shows the master and slave I/O port ad¬ 
dresses. Table 3-3 shows the registers and the requirements to access them. 


Table 3-2 Master and Slave I/O Addresses 


Port 

Master 

Slave 

0 

0020H 

00A0H 

1 

0021H 

00A1H 
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Table 3-3 Accessing the Interrupt Controller Registers 


Register 

R/W 

Port 

Access Method 

ICWl 

W 

0 

When bit 4 of the value written to port 0 equals 1, 
ICWl is selected. 

ICW2 

w 

1 

Must be the next byte written after ICWl. 

ICW3 

w 

1 

The interrupt controller expects ICW3 only if ICWl, 
bit 1 equals 1. If written, ICW3 must be the next 
byte written after ICW2. 

ICW4 

w 

1 

The interrupt controller expects ICW4 only if ICWl, 
bit 0 equals 1. If ICW4 is written and ICW3 is not, 
ICW4 must be the next byte written after ICW2. If 
ICW3 and ICW4 are written, ICW4 must be the 
next byte written after ICW3. 

OCW1 

R/W 

1 

Reading or writing OCW1 requires only that the in¬ 
itialization process be complete. Reading or writing 
OCW1 accesses the interrupt mask register. 

OCW2 

W 

0 

Writing OCW2 requires that the initialization proc¬ 
ess be complete and OCW2 bits 4-3 are equal to 0. 

OCW3 

W 

0 

Writing OCW3 requires that the initialization proc¬ 
ess be complete, OCW3 bit 4 equals 0, and OCW3 
bit 3 equals 1. 

IRR 

R 

0 

Reading the IRR is a two-step process. First, issue 
the read IRR command (write OCW3 with OCW3 
bit 1 equals 1 and OCW3 bit 0 equals 0). Then, read 
the IRR through port 0. Until another command is 
written to OCW3, subsequent reads of port 0 return 
the IRR. 

ISR 

R 

0 

Reading the ISR is a two-step process. First, issue 
the read ISR command (write OCW3 with OCW3 
bit 1 equals 1 and OCW3 bit 0 equals 1). Then, read 
the ISR through port 0. Until another command is 
written to OCW3, subsequent reads of port 0 return 
the ISR. 

Poll Data 

R 

0 

Reading the poll data is a two-step process. First, 
issue the read poll data command (write OCW3 with 
OCW3 bit 2 equals 1). Then, read the poll data 
through port 0. The OCW3 poll command must 
always be written prior to reading the poll data. 
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Initialization Command Words 

The 8259A interrupt controllers do not have a hardware reset. After power is 
applied to the system and until they are initialized, the interrupt controllers are 
in an undefined state. The VAXmate startup code initializes the interrupt 
controllers. 

Initializing the 8259A interrupt controller requires from two to four initializa¬ 
tion command words written in sequence. 

The interrupt controller recognizes ICW1 as the start of an initialization se¬ 
quence. An ICW1 resets the interrupt controller as follows: 

1. The trigger mode is cleared to edge-triggered mode and the edge sense 
circuit is reset. After initialization, an interrupt request input must make 
a low-to-high transition to generate an interrupt. 

2. All bits in the IMR are cleared (enabled). Because the initialization se¬ 
quence enables interrupt inputs, on completion of the initialization se¬ 
quence, the interrupt controllers can immediately issue interrupt 
requests. Therefore, the interrupt vectors and handlers should be in¬ 
itialized prior to initializing the interrupt controllers. 

3. The IRQ7 input is assigned priority 7. 

4. The slave mode address is set to 7. 

5. If ICW1 bit 0 equals 0, all bits in ICW4 are cleared (0). 

6. In the OCW3 register, the special mask mode is cleared (disabled) and 
status read bits are set to read the IRR. 

7. The interrupt controller enters fully nested mode. All other modes of op¬ 
eration are variations of this mode. In fully nested mode, the interrupt 
inputs have a fixed order of decreasing priority and the priority of an 
input corresponds to its input number 0 (highest) - 7 (lowest). While the 
CPU is servicing an interrupt (until the interrupt controller receives an 
end-of-interrupt command), the controller inhibits interrupts of equal or 
lower priority. However, the current interrupt service can be nested in 
favor of a higher priority interrupt as follows: 

- The higher priority interrupt input must be unmasked (enabled). 

- The CPU INTR input must be enabled (STI instruction). 

NOTE 

The 8259A interrupt controller is compatible with two 
microprocessor families, 8080/8085 and 8088/8086/80286. 

Because the VAXmate CPU is an 80286, this manual describes 
only the 80286 application. Those bits dedicated to the 8080/ 

8085 family are unused and described only as belonging to the 
8080/8085 family. 
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The 8259A interrupt controller has the following mutually exclusive methods of 
indicating whether an interrupt controller is a master or a slave: 

• The initialization sequence selects nonbuffered mode in 
ICW4. In nonbuffered mode, a hardware connection to the 
SP/EN pin determines whether the controller is a master 
or a slave. In this mode, a high level at the SP/EN pin 
indicates a master and a low level at the SP/EN pin indi¬ 
cates a slave. The VAXmate workstation uses this method. 

• The initialization sequence selects a buffered master or a 
buffered slave in ICW4. 
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0 


Initialization Command Word 1 (0020H/00A0H) 

7 6 5 4 3 2 



TRIGGER 


SINGLE/ 

ICW4 

MODE 

0 

CASCADE 

REQUEST 


Bit R/W Description 

7-5 W Always 0 (These bits are used only by the 8080/8085 CPU family.) 

4 W Always 1 

For values written to port 0, this bit distinguishes an ICW1 from 
operational command words 2 and 3. For additional information, 
see Table 3-3. 

3 W TRIGGER MODE 

0 = Edge-triggered mode 
1 = Level-triggered mode 

For either trigger mode, a low-to-high transition at an interrupt 
input generates an interrupt request. In edge-triggered mode, to 
generate another interrupt request at the same input, the input 
must change from high to low and back to high. In level-triggered 
mode, while that interrupt input remains high, the controller can 
generate additional interrupt requests for that input. The 
VAXmate startup code initializes the interrupt controllers to edge- 
triggered mode. 

2 W Always 0 (This bit is used only by the 8080/8085 CPU family.) 

1 W SINGLE/CASCADE 

0 = Cascade mode 
1 = Single mode 

Single mode indicates that this is the only interrupt controller in 
the system. Therefore, it is neither a master nor a slave and ICW3 
is not written. Cascade mode indicates that there is more than one 
interrupt controller in the system. Therefore, it is either a master 
or a slave and ICW3 is required. The VAXmate workstation uses 
cascade mode. 

0 W ICW4 REQUEST 

0 = ICW4 is not required 
1 = ICW4 is required 

This bit indicates whether ICW4 is required in the initialization se¬ 
quence. The VAXmate workstation requires ICW4. 


For the master ICW1 and the slave ICW1, use 11H. 
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Initialization Command Word 2 (0021H/00A1H) 


7 

6 

5 

4 

3 

2 

1 

0 

T7 

T6 

T5 

T4 

T3 

0 

0 

0 


Bit R/W Description 


7-3 W Bits 7-3 of the interrupt number for interrupt input 0. 

This value corresponds to the address of the interrupt vector di¬ 
vided by four. The interrupt controller generates a sequential inter¬ 
rupt number for each of the interrupt inputs by OiHng the 
interrupt input number and ICW2. Because the interrupt input 
number is Offed to the value in ICW2, there is no carry involved. 
Therefore, the value in ICW2 must be evenly divisible by 8 
(modulo 8). 

2-0 W Always 0 


For the master ICW2, use 08H. For the slave ICW2, use 70H. 
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Initialization Command Word 3 (0021H/00A1H) 

When there are two or more interrupt controllers in the system, an ICW3 is 
used in the initialization sequence. The VAXmate workstation has two interrupt 
controllers and requires ICW3. The meaning and use of ICW3 depends on 
whether the interrupt controller is a master or a slave. 

ICW3 (Master) 



7 

6 

5 

4 

3 

2 

1 

0 

S7 

S6 

S5 

S4 

S3 

S2 

SI 

SO 

Bit 

R/W 

Description 






7-0 

W 

For each master interrupt input that is connected to a slave, the 
corresponding ICW3 bit is set (1). The master interrupt controller 
can then determine which interrupt inputs require a slave identifi¬ 
cation on the cascade lines. For the master ICW3, use 04H. 

ICW3 (Slave) 








7 

6 

5 

4 

3 

2 

1 

0 







i i 

SLAVE ID 


0 

0 

0 

0 

0 




Bit 

R/W 

Description 






7-3 

W 

Always 0 






2-0 

w 

SLAVE ID - Slave Identification 






The slave identification is the master interrupt input (7-0) to which 
the slave is connected. During the CPU interrupt acknowledge se¬ 
quence, the slave compares its cascade input to these bits. If they 
are equal, the slave places the interrupt vector number on the I/O 
data bus. For the slave ICW3, use 02H. 
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0 


Initialization Command Word 4 (0021H/00A1H) 

7 6 5 4 3 2 1 

SPECIAL 

FULLY BUFFER MASTER/ EOI CPU 

NESTED MODE SLAVE MODE MODE 

0 0 0 MODE 


Bit R/W Description 

7-5 W Always 0 

4 W SPECIAL-FULLY-NESTED MODE * 

0 = Disable special-fully-nested mode 

I = Enable special-fully-nested mode 

3-2 W BUFFERED MODE and MASTER/SLAVE 

OX = Nonbuffered mode - In nonbuffered mode, a hardware con¬ 
nection to the SP/EN pin determines whether the control¬ 
ler is a master or a slave and bit 2, the master/slave 
selection, has no effect. In this mode, a high level at the 
SP/EN pin indicates a master and a low level at the SP/ 
EN pin indicates a slave. The VAXmate workstation uses 
this mode. 

10 = Buffered mode slave - The VAXmate workstation is incapa¬ 
ble of operating in this mode. 

II = Buffered mode master - The VAXmate workstation is inca¬ 

pable of operating in this mode. 

1 W EOI MODE - End-of-interrupt Mode 

0 = Normal EOI - In this mode, the CPU must write an EOI 

command to the interrupt controller. The VAXmate startup 
code initializes the interrupt controller to normal EOI mode. 
The EOI command is explained in the operation command 
word 2 description. 

1 = Automatic EOI - In automatic EOI mode, the interrupt con¬ 
troller generates its own EOI on the second acknowledge 
pulse. 

0 W CPU MODE 

0 = 8080/8085 microprocessor family 

1 = 8088/8086/80286 microprocessor family 

The VAXmate workstation uses the 80286 CPU mode. 

* Special-fully-nested mode is for master interrupt controllers. For the 
master interrupt controller, each slave controller is a single interrupt 
input. Thus, the master controller cannot resolve the priority of the slave 
controller interrupt inputs. If a slave controller has an active, low prior¬ 
ity interrupt that is nested in favor of a higher priority interrupt, the 
master inhibits the new slave interrupt request. This effectively disables 
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nesting of slave interrupts. In special-fully-nested mode, the master inter¬ 
rupt controller acts on all slave interrupt requests, which allows the slave 
to nest interrupts. The VAXmate workstation startup code disables the 
special-fully-nested mode. 

For the master ICW4 and the slave ICW4, use 01H. 

Operation Command Words 

The interrupt controller provides three operation command words (1-3) that are 
programmed after the initialization sequence is complete. The operation com¬ 
mand words select various modes or operations as follows: 

• Read or write the interrupt mask register 

• Accept specific or nonspecific end-of-interrupt commands 

• Enable or disable various automatic priority rotation schemes 

• Set a specific priority level 

• Set or reset the special mask 

• Read poll data 

• Read the interrupt request register 

• Read the in-service register 

Operation Command Word 1 (0021H/00A1H) 

76543210 

- 1 - 1 - 1 - 1 - 1 - 1 - 1 - 

MASK BITS 

_I_I_I_I_I_I_I_ 


Bit R/W Description 


7-0 R/W Interrupt mask register bits 

0 = Corresponding interrupt inputs are unmasked (enabled) 
1 = Corresponding interrupt inputs are masked (disabled) 


OCW1 reads or writes the interrupt mask register (IMR). Each bit in the IMR 
enables or disables the corresponding interrupt input. 
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Operation Command Word 2 (0020H/00A0H) 


7 

6 

C 

-J 

4 

3 

2 10 

ROTATE 

SL 

EOI 

0 

0 

i i 

INTERRUPT LEVEL 

_1_1_ 


Bit R/W Description 


7-5 W ROTATE/SL/EOI 

000 = Disable rotation in automatic EOI mode 
001 = Nonspecific end-of-interrupt (EOI) 

010 = No operation 

Oil = Specific end-of-interrupt 

100 = Enable priority rotation in automatic EOI mode 

101 = Rotate priority on nonspecific EOI 

110 = Rotate priority to specific interrupt input 

111 = Rotate priority on specific EOI 

4 W Always 0 

For values written to port 0. this bit distinguishes operational com¬ 
mand words 2 and 3 from an ICW1. See Table 3-3. 

3 W Always 0 

This bit distinguishes OCW2 from OCW3. See Table 3-3. 

2-0 W INTERRUPT LEVEL 

For interrupt-specific operations, these bits contain the interrupt 
input number (0-7) to act on. For nonspecific operations, these bits 
are ignored. 


OCW2 issues an end-of-interrupt command or sets a priority rotation mode. 
Some OCW2 operations are nonspecific. (They act on the interrupt input that 
has the highest priority, whichever one that may be.) Non-specific commands 
do not use INTERRUPT LEVEL (OCW2 bits 2-0). Specific OCW2 operations 
require the interrupt input number (0-7) in INTERRUPT LEVEL. 

For the master OCW2 and the slave OCW2, use 20H (nonspecific EOI 
command). 
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Priority Rotation 

In nonspecific or automatic EOI mode, priority rotation has the effect of 
assigning equal priorities to all interrupt inputs. On receipt of an EOI com¬ 
mand, the interrupt controller assumes that the active interrupt input with the 
highest priority is the interrupt just completed. The priority bits are rotated 
until the just completed interrupt has the lowest priority (7). If that interrupt 
input requires further service, it must wait until it is again the highest priority 
interrupt or until all interrupts of higher priority are inactive. 

In Figure 3-1, interrupt inputs 2, 5, and 6 are requesting service and interrupt 
input 2 has a higher priority than interrupt inputs 5 and 6. After interrupt 
input 2 is serviced, the interrupt controller rotates the priority as shown in 
Figure 3-2. In Figure 3-2, interrupt input 3 has the highest priority, but it is 
inactive. Because interrupt input 5 has the highest priority of the active inter¬ 
rupts, it is the next interrupt input serviced. 

Rotating priorities to a specific interrupt input is another method of priority 
rotation. In this method, the lowest priority is set, thereby fixing all other 
priorities. For example, if interrupt input 2 is programmed as the lowest prior¬ 
ity, then interrupt input 3 becomes the highest. OCW2 bits 2-0 define the in¬ 
terrupt input number that is assigned the lowest priority. This method is not 
used in the VAXmate workstation startup code. 
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In-Service Bits 


7 

6 

5 

4 

3 

2 

i 

0 

0 

1 

1 

0 

0 

1 

0 

0 

Priority Status 







7 

6 

5 

4 

3 

2 

1 

0 

7 

6 

5 

4 

3 
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1 

0 



Figure 3-1 Priority Before Rotation 
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Figure 3-2 Priority After Rotation 
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Operation Command Word 3 (0020H/00A0H) 

76543210 


ENABLE SPECIAL 

SPECIAL MASK POLL 

MASK MODE 

0 MODE 0 1 


READ READ 
IR REG IS REG 


Bit R/W Description 

7 W Always 0 

6-5 W ENABLE SPECIAL MASK MODE/SPECIAL MASK MODE 

00 = No action 

01 = No action 

10 = Disable special mask mode 

11 = Enable special mask mode 

Some operations require that an interrupt service routine dynami¬ 
cally change the priority structure. Masking an interrupt input in 
the special mask inhibits that priority level and enables all other 
priority levels (lower and higher! that are unmasked. After enabling 
special mask mode, the special mask is read or written to the 
IMR. 

4 W Always 0 

For values written to port 0, this bit distinguishes operational com¬ 
mand words 2 and 3 from an ICW1. See Table 3-3. 

3 W Always 1 

This bit distinguishes OCW3 from OCW2. See Table 3-i>. 

2-0 W POLL/READ IR REG/READ IS REG 

000 = No action 
001 = No action 
010 = Read the IRR. * 

Oil = Read the ISR. * 

100 = Read the poll data. ** 

101 = Read the poll data. ** 

110 = Read the poll data. ** 

111 = Read the poll data. ** 

* See Table 3-3 and the IRR/ISR description. 

** See Table 3-3 and the poll command description. 

For standard operation of the VAXmate workstation, neither the master nor 
the slave use OCW3. 


Interrupt Controllers - Hardware Description 3-15 











Interrupt Request and In-Service Registers 

Interrupt Request Register 


7 

6 

5 

4 

3 

2 

1 

0 

IRQ7 

IRQ6 

IRQ5 

IRQ4 

IRQ3 

IRQ2 

IRQ1 

IRQO 

In-Service Register 






7 

6 

5 

4 

3 

2 

1 

0 

IS7 

IS6 

IS5 

IS4 

IS3 

IS2 

IS1 

ISO 


The Interrupt Request Register (IRR) and the In-Service Register (ISR) main¬ 
tain the state of the interrupt controller. During the first interrupt acknowledge 
of the CPU interrupt acknowledge sequence, the IRR latches the state of the 
interrupt input lines. The internal output of the Interrupt Mask Register (1MR) 
gates the output of the IRR to the priority encoder. Assuming that one or 
more IRR bits are set (active) and unmasked (enabled), the priority encoder de¬ 
termines which one has the highest priority. During the second interrupt ac¬ 
knowledge, that IRR bit is strobed into the corresponding ISR bit, the edge 
sense circuitry for that interrupt input is reset, and the interrupt vector 
number is placed on the I/O data bus. 

Because the interrupt controller can nest interrupts, the ISR can contain one, 
two, or more bits that are set. This shows that another interrupt was acknowl¬ 
edged before other interrupt processing was completed. A specific end-of- 
interrupt (EOI) clears the indicated ISR bit. A nonspecific EOI clears the 
highest-priority ISR bit. 

If an IRR bit is set (active) and masked (disabled), unmasking (enabling) that 
active IRR bit creates an interrupt. 
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Poll Command 

When issued, the poll command performs steps similar to those described in 
the IRR/ISR description. The poll command replaces the function of the CPU 
interrupt acknowledge sequence. Instead of placing the interrupt vector number 
on the I/O data bus, the poll command connects the output of the poll data 
register to the port 0 output buffer. The polling interrupt handler then reads 
the poll data to determine if an interrupt input is active and, if so, which one. 
To complete the interrupt sequence, the polling interrupt handler must issue an 
EOI. 

Poll Data Register 


76543210 


INT 

ACTIVE 





-1-1- 

INTERRUPT INPUT 

FLAG 

0 

0 

0 

0 

NUMBER 

_1_1_ 


Bit Description 

7 R INT ACTIVE FLAG - Interrupt active flag 
0 = No active interrupt inputs 
1 = At least one interrupt input is active 

6-3 R Always 0 

2-0 R INTERRUPT INPUT NUMBER 

If bit 7 equals 1, these bits contain the interrupt input number (0- 
7) of the highest priority interrupt input that is active. If bit 7 
equals 0, these bits have no meaning. 
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Interrupt Sequence 

The following list describes interrupt processing. Each item in the list describes 
a system state or event. After a discussion of the state or event, the descrip¬ 
tion indicates the next state or event. For the following interrupt processing 
description, it is assumed that the interrupt controllers are initialized as pre¬ 
viously described. Later, Figure 3-3 shows the same logic in the form of a flow 
chart. 


1. Until one or more interrupt controller input lines become active, the con¬ 
troller is idle. If one or more inputs are active, go to 2. 

2. If any of the newly active inputs are unmasked (enabled), go to 4. 
Otherwise, go to 3. 

3. If other interrupt inputs are pending, go to 5. Otherwise, go to 1. 

4. If no other interrupt inputs are pending, go to 7. Otherwise, go to 6. 

5. If the controller is waiting for an end-of-interrupt command, go to 6. 
Otherwise, go to 7. 

6. If any interrupt has a priority higher than the one being processed by 
the CPU, nest the interrupts and go to 7. Otherwise, go to 8. 

7. The controller activates its interrupt output line and waits for an ac¬ 
knowledge signal from the CPU. 

If the interrupt controller input is a slave input, then the slave interrupt 
output line activates the master interrupt controller IR.Q2 interrupt 
input. The master interrupt process starts at step 2. Eventually, the 
master IR.Q2 input becomes the highest priority master interrupt that is 
active and the master controller arrives at this step. At that time, both 
controllers are waiting for the CPU acknowledge signal. 

In either case, the master interrupt controller activates its interrupt 
output line, which triggers an external latch. The external latch drives 
the CPU INTR input. 

NOTE 

This external latch, between the master interrupt controller in¬ 
terrupt output and the CPU INTR input, was incorporated due 
to an advisory on an 80286 CPU design flaw. 

Disabling the CPU INTR input before disabling an interrupt 
controller input or initializing the interrupt controllers can leave 
the latch set. On reenabling the CPU INTR input, the latch 
could indicate an interrupt request when none exists. 

To avoid this situation, disable the interrupt controller input or 
write the first master interrupt controller initialization command 
before disabling the CPU INTR input. 
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If the CPU INTR input is disabled, the interrupt controller continues to 
wait. If other interrupt controller inputs become active during this waiting 
period, go to 2. When the CPU INTR input is enabled, the CPU recog¬ 
nizes the interrupt request and responds with an acknowledge signal. 

On receiving the acknowledge, the interrupt controller sets the highest 
priority bit in the in-service register and resets the corresponding bit in 
the interrupt request register. This allows the controller to recognize an¬ 
other interrupt request at that interrupt controller input. 

The CPU issues a second acknowledge signal. When the master interrupt 
controller recognizes the second acknowledge signal, it determines 
whether the interrupt input source is a slave interrupt controller. If the 
interrupt input source is not a slave, the master controller places a 
preprogrammed 8-bit interrupt vector on the input/output (I/O) data bus. 

If the interrupt input source is a slave, the master controller places the 
slave address (master interrupt input number 0-7) on the cascade lines. 
When enabled by the slave address on the cascade lines, the slave places 
the preprogrammed 8-bit interrupt vector on the input/output (I/O) data 
bus. In either case, the CPU reads the 8-bit interrupt vector, stacks the 
current state and begins executing the interrupt handler that is pointed 
to by the contents of the interrupt vector. 

8. The interrupt controller(s) are waiting for an end-of-interrupt (EOI) com¬ 
mand. When a slave interrupt is processed, an EOI command is required 
by both the slave and the master. 

If an interrupt occurs during this waiting period, go to step 2. When the 
CPU writes the end-of-interrupt command, go to step 1. 
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Figure 3-3 Interrupt Sequence 
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Programming Example 

The following programming examples demonstrate: 

• Initializing a master or slave 8259A peripheral interrupt controller (PIC) 

• Programming the PIC interrupt mask register 

• Issuing end-of-interrupt commands to a master or slave PIC 

The example provides routines as described in the following: 

picinit Initializes the master and slave PICs. 

imask Masks or unmasks the specified bit in the interrupt mask 

register. 

eoi Issues an end-of-interrupt command to the appropriate PICs. 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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Constant Values and Data Structures 

The constant value NPIC defines the number of peripheral interrupt controllers 
in the VAXmate workstation. 

The constant value EOI defines the bit value that must be issued to OCW2 to 
establish an end-of-interrupt condition. 

The structure type PIC defines the input/output ports of the 8259A peripheral 
interrupt controller (PIC). These two ports access the PIC registers. The bit 
values written to registers and the read or write sequence determine the ac¬ 
cessed register. 

The structure type PIC_DAT defines the type of data required to initialize a 
PIC. 

Initialization Data 

The array of structures allpics provides the actual data for initializing the 
master and slave PICs. Later, references to the PIC number refer to the posi¬ 
tion of an element in the array allpics. 
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/* define constants and structures used in 8259 PIC example */ 

/He******************************************************************#***/ 

#define NPIC 2 /* number of pics in system */ 

#define EOI 0x20 /* bit value of EOI command */ 


typedef struct 

{ 

unsigned char portO; 
unsigned char portl; 

> PIC; 

typedef struct 

i 

PIC *base; 
char icw2; 
char icw3; 
char icw4; 

> PIC_DAT; 


/* define pic I/O structure */ 

/* when address line AO * 0 */ 
/* when address line AO “ 1 */ 


/* base I/O address of pic */ 
/* modulo 8 base int vector */ 
/* ir has a slave or slave id */ 
/* icw4 mode data */ 


/* define pic initialization data */ 

/*$************H<****************$*****H'***H<:)|'4:**:|'*’l'**’t'>l'*$***’l'$**$’l<’l'’t'’l‘’l ( >f‘ 9 i'’i c / 

/* device data tables */ 

/* pic 0 is the master */ 
/* pic 1 is the slave */ 


PIC_DAT allpics[NPIC] = 

< 

{ (PIC *)0x0020, 0x08, 0x04, 0x01 >, 
{ (PIC *)0x00a0, 0x70, 0x02, 0x01 >, 
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Initializing the Peripheral Interrupt Controller 

The function picjlnit initializes the master and slave PICs. Because the ROM 
BIOS startup sequence initializes the peripheral interrupt controllers (PIC), in¬ 
itialization of the PICs is not normally required. 

Because the initialization sequence clears the interrupt mask register, the CPU 
interrupt flag is cleared after the initialization is started and before the initiali¬ 
zation is complete. Thus, no interrupts are pending when the initialization is 
started and the CPU will not respond to any interrupts that become active 
during the initialization sequence. 

The first two instructions write a value to port 0 of the indicated PIC. The 
value of bit 4 is key to this operation. Writing a value to port 0, with bit 4 set, 
selects the ICW1 register and indicates a reset sequence. The PIC stores the 
remaining ICW1 bits in the ICW1 register, which starts the initialization 
sequence. 

• Bit 0 is set, indicating that the initialization sequence includes ICW4. 

• Bit 1 is clear, indicating that the addressed PIC is involved in a cascade 
(master/slave) arrangement and that ICW3 must be written during the in¬ 
itialization sequence. That is, the PIC is not operating in a standalone 
environment. 

• Bit 3 is clear, indicating that the PIC is operating in edge-triggered mode. 

• All other ICW1 bits apply to the 8085 mode of operation and are not 
used. 


Because two PICs must be initialized, the rest of the initialization sequence is 
performed within a for loop as follows: 

1. The first instruction initializes a pointer to the required data. 

2. The second instruction initializes a pointer to the port 0 I/O address. 

3. The third instruction writes the base interrupt vector to port 1. Because 
this is the second value written in the sequence, the PIC routes the 
value to ICW2. 

This base interrupt vector refers to the interrupt vector for interrupt 
input zero. To generate a unique interrupt vector number for each inter¬ 
rupt input, the PIC ORs the interrupt input number (0-7) and the base 
interrupt vector number. Therefore, the base interrupt vector must be 
modulo 8. 

4. The fourth instruction is dependent upon whether the PIC is a master or 
a slave. Because this is the third value written in the sequence and 
ICW1 indicated a cascade mode, the PIC routes the value to ICW3. 
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• If the PIC is a master, each bit set in the value indicates that the 
corresponding interrupt input is connected to a slave PIC. For the 
VAXmate, only bit 2 is set. 

• If the PIC is a slave, the value is the slave identification. The slave 
identification is a value between 0 and 7 inclusive, and corresponds to 
the master interrupt input to which it is connected. 


/**** *******************************************************************/ 
/* pic_init() - initialize master and slave pics */ 

/*£*:4c*j|c:|c$:te9|c9tc:|c$:tc*:)|c*****************:|c$:*:****:fc**************H‘****H<**********/ 

void pic_init() /* initialize all pics */ 

{ 


int i; 

int intr_flg; 
register PIC_DAT *ppd; 
register PIC *pps; 

outp(allpics[0].base, Oxll); 
outp(allpics[l].base, 0x11); 
intr_flg = int_off(); 
for(i = 0; i < NPIC; i++) 

ppd - ftallpics[i]; 
pps « ppd->base; 
outp(&pps->portl t ppd->icw2); 
outp(&pps->portl, ppd->icw3); 
outp(fcpps->portl, ppd->icw4); 
outp(&pps->portl, Oxff); 

> 

int_on(intr_flg); 


/* variable for loop control */ 
/* to hold CPU IF state */ 
/* pointer to PIC data */ 
/* pointer PIC I/O structure */ 

/* write master ICW1 is cascade */ 

/* write slave ICW1 is cascade */ 

/* turn CPU interrupts off */ 

/* assign pointer to PIC data */ 
/* assign pointer to I/O ports */ 
/* write ICW2 */ 

/* write ICW3 */ 

/* write ICW4 */ 

/* mask all interrupts */ 

/* turn CPU interrupts on */ 


5. The fifth instruction writes the ICW4 value to port 1. 

• Bit 0 determines the microprocessor family. In this case, it is set and 
indicates the 8086/80286 mode. 

• Bit 1 is clear, indicating that the interrupt handling routine issues an 
end-of-interrupt command after the interrupt is processed. 

• Bits 2 and 3 are clear, indicating the nonbuffered mode of operation. 
For the VAXmate, a permanent hardware connection determines the 
master/slave relationship. 

• Bit 4 is clear, indicating that the PIC is not in special-fully-nested 
mode. 

• All other bits are not used and are clear. 
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6. The sixth instruction masks (disables) all interrupts. The interrupt inputs 
must be unmasked before the PIC can generate an interrupt to the CPU. 

To complete the initialization, the last instruction enables CPU interrupts. 
Because the PIC interrupt mask is cleared during initialization, it is possible 
that the PIC will recognize an active interrupt input between instructions 5 and 
6. Before a PIC interrupt input is unmasked, an interrupt handler must be 
available and the appropriate interrupt vector initialized. 

A PIC interrupt input that is not active long enough to be latched is considered 
a glitch. If a glitch occurs, the PIC generates an interrupt for IR.Q7 (master) or 
IRQ15 (slave). To determine whether an interrupt for IRQ7 or IRQ15 is a 
glitch, test ISR bit 7 of the appropriate controller. If the ISR bit 7 is set, the 
interrupt is a valid interrupt. If the ISR bit 7 is clear, the interrupt is a glitch. 

Issuing an End-of-Interrupt Command 

In fully nested mode (default mode), the PIC processes the highest priority in¬ 
terrupt that is pending. When the PIC receives a nonspecific end-of-interrupt 
(EOI), it clears the highest priority bit that is set in the in-service register. 

Until no interrupts are pending, the PIC continues by processing the highest 
priority interrupt that is pending. 

To allow the PIC to process the same interrupt or an interrupt of lower prior¬ 
ity, the eoi function is called at the end of an interrupt handling sequence. The 
calling parameter indicates which PIC issued the interrupt. If an interrupt is 
issued by the slave PIC, an EOI must be issued to the slave and then to the 
master. 

During interrupt processing, it is possible for a higher priority interrupt to 
become active. If this happens, the PIC attempts nesting the interrupts. For 
the PIC to nest interrupts, the CPU interrupt request input must be enabled. 
Otherwise, the CPU will not issue the required acknowledge sequence. During 
the interrupt processing, the CPU automatically stacks its current state and 
clears the interrupt enable flag. Because none of the interrupt handlers, in 
these examples, enable the CPU interrupt request input, nesting of interrupts 
is effectively disabled. 

Masking Interrupts 

The function imask masks or unmasks a bit in the interrupt mask register 
(OCWI). The calling parameters indicate the PIC number, the bit number (0-7), 
and whether the bit should be masked or unmasked. 
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/* eoi() - establish End-Of-Interrupt for pic(s) */ 

Z********************************************^********************)^*****/ 


void eoi(pic) 
int pic; 

< 


/* send nonspecific EOI */ 
/* which pic handled interrupt */ 


outp(ft(allpics[pic].base)->portO, EOI); 
if(pic) 

outp(&(allpics[0].base)->portO, EOI); 


/* write eoi as indicated */ 
/* was it the slave pic ? */ 
/* write eoi to master */ 


j jJ{ jjj jJ( j|^ )J{ jJ^ jJ{ jJj jJj ^ jJ^ jJj jj^ ^ jJ^ ^ ^ j||» ^ ^ ^ ^ ^ ^ ^ ^ 2|( jjg ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^jc ^ ^ ^ ^ ^ ^ ^ ^ jJ^ ^ ^ ^ ^ J 

/* imaskO - mask or unmask desired bit in pic mask register */ 


void imask(pic, bitno, enable) 

int pic; 
int bitno; 
int enable; 

{ 

unsigned char current; 
unsigned char mask; 
register PIC *pps; 

pps = allpics[pic].base; 
current = inp(&pps->portl); 
mask = 1 << bitno; 
if(enable) current &= ~mask; 
else current |* mask; 
outp(fcpps->portl, current); 


/* set or clear bit in mask */ 
/* register of desired pic */ 
/* which pic ? */ 
/* which bit ? */ 
/* enable or disable ? */ 


/* current contents of MR */ 
/* the mask to write */ 
/* pointer PIC I/O structure */ 

/* assign pointer to I/O ports */ 
/* read current mask */ 
/* set up correct bit */ 
/* clear the bit */ 
/* or set it */ 
/* write the resulting mask */ 
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Chapter 4 
DMA Controller 


Overview 

The direct-memory-access (DMA) controller is an Intel 8237A-5, programmable, 
DMA controller operating at 4 MHz. The DMA controller allows the direct 
transfer of 8-bit data between DMA-capable, input/output (I/O) devices and 
memory. The DMA controller has four, independent DMA channels. Table 4-1 
lists the assignment of the four DMA request lines. Each channel has 16 ad¬ 
dress lines and an external 8-bit page register. Thus, each channel can transfer 
a maximum of 64 Kbytes anywhere in the 16 Mbyte address range. 

The following list shows the operational modes and restrictions of the DMA 
controller. 


Single transfer 
Block transfer 

Demand transfer 

Cascade 

Compressed timing 


This is the suggested mode of operation. 

To prevent interference with DRAM refresh cycles, 
limit block transfers to 8 transfers per block. 

To prevent interference with the DRAM refresh 
cycle, limit demand transfers to 8 transfers per 
demand. 

As bus master, the slave DMA controller should re¬ 
lease the bus after 10 /us. 

Compressed timing is not supported by the processor 
board hardware. 


Memory to memory Memory-to-memory transfers are not supported by 

the processor hardware. 

Extended write cycle The extended-write cycle does not provide sufficient 

data setup time. Use the normal DMA write cycle. 
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Table 4-1 DMA Request Line Assignments 


Channel 

Request Line 

0 

Available 

1 

Available 

2 

Diskette Controller 

3 

Available 


Additional Source of Information 

The following Intel Corporation document provides additional information: 

• Microsystem Components Handbook (Publication Number 230843) 

Operation 

When the DMA controller receives a DMA request from a peripheral device, 
the DMA controller sends a hold request signal to the CPU. When the CPU 
responds with a hold acknowledge signal, the DMA controller takes control of 
the I/O data bus, the system address bus, and the control bus. The controller 
then generates a 16-bit memory address and activates the corresponding DMA 
acknowledge line, the I/O read or write line, and the memory read or write line. 
On seeing the DMA acknowledge, the DMA-capable I/O device transfers (reads 
or writes) the data on the data bus. Thus, the data is transferred directly be¬ 
tween the I/O device and memory. 

The DMA controller operates in two major cycles, idle and active. Each DMA 
cycle can assume seven, separate states. Each state is composed of one full, 
clock period. Table 4-2 describes the various controller states. 

Table 4-2 DMA Controller States 


State Description 


SI This is the inactive state. No valid DMA requests are pending and the 

CPU can program the DMA controller. 

SO This is the first active state of DMA service. The controller has re¬ 
quested a CPU hold, but the CPU has not acknowledged a hold. 
Programming of the DMA controller can continue until the acknowl¬ 
edge is received. 

S1-S4 These are the DMA working states. 

SW When more time is required to complete a transfer, wait states are 
inserted between S2 and S3, or S3 and S4. 
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Idle Cycle 

When none of the I/O channels is requesting DMA service, the DMA controller 
enters the idle cycle and performs SI states. At each clock cycle in the idle 
cycle, the DMA controller samples the DMA request lines and the chip select 
line. 

If a DMA request line becomes active, the DMA controller goes to the active 
state. Otherwise, if CPU has selected the DMA controller and the CPU has 
control of the bus, the CPU can read or write the DMA controller internal 
registers. 


Active Cycle 

When the DMA controller is in the idle cycle and a nonmasked channel 
requests DMA service, the controller issues a hold request to the CPU and 
enters the active cycle. The DMA service will then occur in one of the four 
following modes. 

Single Transfer Mode 

The DMA controller is programmed to perform only one transfer in this mode. 
After the transfer, the word count is decremented and the address is either 
decremented or incremented. When the word count goes from 0000H to 
FFFFH, a terminal count (TC) signal is generated, and will auto-initialize the 
channel to its original condition if it had been programmed to do so. 

The ROM BIOS uses this mode for data transfers between the diskette control¬ 
ler and memory. 

Block Transfer Mode 

In this mode, the DMA controller is activated by a DMA request to continue 
making transfers until a TC (word count has reached FFFFH) or an external 
end-of-process (EOP) signal occurs. If the channel has been programmed for 
auto-initialization, the auto-initialization occurs at TC or EOP. This mode 
should be limited to eight transfers (assuming no additional wait states) to pre¬ 
vent interference with refresh cycles. 

Demand Transfer Mode 

The DMA controller performs transfers until a TC or external EOP occurs, or 
until there is no DMA request. Transfers may continue until the I/O device has 
exhausted its data capacity. Once the I/O device has caught up, DMA service is 
reestablished by means of a DMA request. The intermediate values of address 
and word count are stored in DMA controller internal registers between serv¬ 
ices while the CPU is running. At the end of the service, only an EOP can 
cause auto-initialization to occur. This mode should be limited to eight transfers 
per demand to prevent interference with refresh cycles. 
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Cascade Mode 

This mode is used when DMA controllers are cascaded for system expansion. 

In this configuration, the initial controller determines the priority of the addi¬ 
tional controllers. Each of the additional controllers establish priority within 
themselves and make the DMA request to the initial controller. The initial con¬ 
troller does not output any address or control signals, since they could conflict 
with the outputs of the added controller. 

Data Transfers 

The DMA controller can perform read, write, or verify operations in each 
transfer mode. Read transfers move data from memory to an I/O device; write 
transfers move data from an I/O device to memory; and verify transfers are 
pseudo data transfers. In verify mode, the controller operates as if in read or 
write mode, however the memory and I/O control lines are not active. 

Memory-to-memory transfers are a special case of DMA transfer. Channel 0 is 
the source and channel 1 is the target. In memory-to-memory transfers, chan¬ 
nel 0 uses one cycle to read the data byte and store it in the temporary regis¬ 
ter. On the following cycle, channel 1 writes the value in the temporary 
register to the target location. 

Auto-Initialize 

Restores the DMA channel to its original condition following an EOP. Auto¬ 
initialization is accomplished by restoring the original values of the Current 
Address and Current Word Count registers from the Base Address and Base 
Word Count registers. The CPU loads the current registers and base registers 
which do not change during the DMA service. When the channel is in auto- 
initialize mode, the mask bit is not set. After auto-initialization and a receipt of 
a DMA request, the channel can perform DMA service without CPU 
intervention. 
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Priority 

The two types of priority, fixed and rotating, are defined as follows: 

Fixed Priority In fixed priority, the channels are placed in order based 
on the descending value of their assigned number. The 
assigned number range is from zero to three (0-3), with 
zero as the highest priority. 

Rotating Priority The channel being serviced is assigned lowest priority 
value, and all others rotate to the next higher value. 

Address Generation 

The eight, high-order address bits (15-8) are multiplexed on the I/O data lines. 
At the SI state, the high-order 8-bits are output to an external latch and 
placed on the system address bus. The low-order bits are output directly from 
the DMA controller to the system address bus. For multiple transfers, such as 
block and demand transfers, the addresses are generated sequentially. The data 
in the external latch (high-order byte) can remain the same for many transfers, 
and have to be changed only when a borrow or carry takes place in the normal 
sequence of addresses. The controller executes SI states only when updating of 
the high-order byte is required. 
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Table 4-3 DMA Controller and Page Register Address Map 


Port 

R/W 

Channel 

Register 

0000H 

W 

0 

Base and Current address 


R 

0 

Current address 

0001H 

W 

0 

Base and Current word count 


R 

0 

Current word count 

0002H 

W 

1 

Base and Current address 


R 

1 

Current address 

0003H 

W 

1 

Base and Current word count 


R 

1 

Current word count 

0004H 

W 

2 

Base and Current address 


R 

2 

Current address 

0005H 

W 

2 

Base and Current word count 


R 

2 

Current word count 

0006H 

W 

3 

Base and Current address 


R 

3 

Current address 

0007H 

W 

3 

Base and Current word count 


R 

3 

Current word count 

0008H 

W 

. 

Command 


R 

- 

Status 

0009H 

W 

- 

Request 

000AH 

W 

- 

Write single mask register bit 

000BH 

W 

- 

Mode register 

000CH 

W 

- 

Clear byte pointer flip/flop 


R 


Temporary 

OOODH 

W 

- 

Master clear 

000EH 

W 

- 

Clear mask register 

000FH 

W 

- 

Write all mask register bits 

0080H 

W 

1 

Channel 1 page register 

0081H 

w 

2 

Channel 2 page register 

0082H 

w 

3 

Channel 3 page register 

0083H 

w 

0 

Channel 0 page register 
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Registers 

The DMA controller has 16 I/O ports to access 26 internal registers. 
Additionally, the DMA circuitry has four I/O ports to access four page regis¬ 
ters. Table 4-3 lists the I/O ports and the registers accessed. 


Base and Current Address Register 
(0000H/0002H/0004H/0006H) 


7 

6 

5 4 3 2 


1 

0 

i i i i i i i 

LOW BYTE OF ADDRESS 

READ OR WRITTEN FIRST 

_1_1_1_1_1_1_1_ 

15 

14 

13 12 11 10 


9 

8 


1 

• lit 

HIGH BYTE OF ADDRESS 
READ OR WRITTEN SECOND 

J_1_1_1_ 

i 

1 

_1 

1_ 


Each DMA channel has a 16-bit base address register and a 16-bit current ad¬ 
dress register. The base address register contains the initial value. Writing a 
value to the base address register initializes the current address register to the 
same value. The current address register is incremented or decremented after 
each transfer. When the required number of transfers have occurred and if 
auto-initialize (see the mode register) is enabled, the current register is in¬ 
itialized from the base register. 

Before performing a 16-bit read or write, clear the byte pointer flip/flop. 

To write a base register, write two, 8-bit bytes in succession to the same port. 
To read a current register, read two, 8-bit bytes in succession to the same port. 
In either case, the low byte is accessed first and then the high byte. 
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Base and Current Word Register 
{0001H/0003H/0005H/0007H) 


7 

6 

5 4 3 2 

1 

0 


1 

i i. i i i 

LOW BYTE OF CURRENT WORD 




1 

READ OR WRITTEN FIRST 

1 1 1 1 1 



15 

14 

13 12 11 10 

9 

8 


i 

l i i i i 

HIGH BYTE OF CURRENT WORD 

1 1 

1 



READ OR WRITTEN SECOND 

1_1_1_1_1 

1 _ 1 

1 


Each DMA channel has a 16-bit base word count register and a 16-bit current 
word count register. The value written to this register determines the number 
of transfers performed. The number of transfers is the programmed value plus 
one. The current word count is decremented after each transfer. When the cur¬ 
rent word count is decremented below zero (FFFFH>, a terminal count is gener¬ 
ated. When the required number of transfers have occurred and if auto-initialize 
(see the mode register) is enabled, the current register is initialized from the 
base register. 

Before performing a 16-bit read or write, clear the byte pointer flip/flop. 

To write a base register, write two, 8-bit bytes in succession to the same port. 
To read a current register, read two, 8-bit bytes in succession to the same port. 
In either case, the low byte is accessed first and then the high byte. 
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3 


2 


1 


0 


Command Register (0008H) 

7 6 5 4 


DACK 

DREQ 

WRITE 

PR 

TIMING 

CE 

CHANNEL 

0 

MEMORY 

TO 

SENSE 

SENSE 

SELECT 




ADDRESS 

HOLD 

MEMORY 


Bit R/W Description 

7 W DACK SENSE - DMA Acknowledge Sense 
0 = DACK sense active low 
*1 = DACK sense active high 

6 W DREQ SENSE - DMA Request Sense 

0 = DREQ sense active high 
1 = DREQ sense active low 

5 W WRITE SELECT 

0 = Late write selected 
1 = Extended write selected 

For the VAXmate workstation, the extended write mode does not 
provide an adequate write cycle. Use only the late write mode. 

If bit 3 equals 1 (compressed mode), bit 5 is a don’t care value. 
However, the VAXmate workstation is not capable of using com¬ 
pressed mode. 

4 W PR - Priority 

0 = Fixed priority 0 (highest), 1, 2, and 3 (lowest) 

1 = Rotating priority 

Initially, the priority is the same order as in fixed priority. In the 
rotating priority scheme, the currently serviced DMA channel be¬ 
comes the lowest priority channel. However, the channels always 
maintain their priority in numeric order. That is, the priority de¬ 
creases as the channel number increases and wraps between chan¬ 
nels 3 and 0. 
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Bit R/W Description (Command Register - cont.) 

3 W TIMING 

0 = Normal read/write timing - A read/write cycle requires a 

minimum of three clock cycles and is subject to wait states. 
The VAXmate workstation uses this mode. 

1 = Compressed read/write timing - A read/write cycle occurs in 
two clock cycles. The VAXmate workstation is not capable of 
using compressed mode. 

If bit 0 equals 1 (memory-to-memory enabled), bit 3 (timing) is a 
don’t care value. 

2 W CE - Controller Enable 

0 = Controller disabled 
1 = Controller enabled 

1 W CHANNEL 0 ADDRESS HOLD 

0 = Disable channel 0 address hold 
1 = Enable channel 0 address hold 

Channel 0 address hold causes the DMA controller to copy a single 
byte to the specified number of destination bytes. 

If bit 0 equals 0 (memory-to-memory disabled), bit 1 (channel 0 ad¬ 
dress hold) is a don’t care value. 

0 W MEMORY-TO-MEMORY 

0 = Memory-to-memory transfers disabled 

1 = Memory-to-memory transfers enabled 

The VAXmate workstation does not support memory-to-memory 
transfers. 


This 8-bit register controls the operation of the DMA controller. It is cleared by 
a hardware reset or a master clear instruction. 
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Write Single Mask Bit (OOOAH) 

76543210 


-,- 1 - 1-1 - 

MASK 

- 1 - 

DON'T CARE 

_ 1 _ 1 _ 1 _ 1 _ 

BIT 

CHANNEL SELECT 

_ 1 _ 


Bit R/W Description 


7-3 

W 

DON’T CARE (any value) 

2 

W 

MASK BIT 



0 = 

Enable the selected channel 



1 = 

Disable the selected channel 

1-0 

w 

CHANNEL SELECT 



00 = 

Select channel 0 mask bit 



01 = 

Select channel 1 mask bit 



10 = 

Select channel 2 mask bit 



11 = 

Select channel 3 mask bit 


Each channel has a mask bit, which can be set to disable the incoming DMA 
request. These bits are set if their associated channel produces an EOP and 
auto-initialize is not enabled. 


Write All Mask Bits (000FH) 

76543210 


- \ - 1 -1- 

DON'T CARE 

J J 1 

-1-1-1- 

MASK BITS 

CHANNEL CHANNEL CHANNEL CHANNEL 

3 2 10 

1_ 1 _1_ 

Bit 

R/W 

Description 



7-4 

W 

DON’T CARE (any value) 



3-0 

w 

MASK BITS 

0 = Enable the indicated channel (CHANNEL 3-0) 

1 = Disable the indicated channel (CHANNEL 3-0) 
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Mode Register (000BH) 

76543210 


OPERATION 

INCR/ 

AUTO 

MODE 

i 

DEGR 

SELECT 

INIT 



CHANNEL SELECT 


Bit R/W Description 


7-6 W OPERATION MODE 

00 = Demand mode 
01 = Single mode 

10 = Block mode 

11 = Cascade mode 

5 W INCR/DECR SELECT - Increment/Decrement selection 

0 = Increment selected 
1 = Decrement selected 

4 W AUTO INIT - Auto-initialization enable 

0 = Disable auto-initialization 

I = Enable auto-initialization 

3-2 W TRANSFER TYPE 

00 = Verify 

01 = Write 

10 = Read 

II = Invalid value 

A read transfer moves data from memory to the I/O device. A 
write transfer moves data from the I/O device to memory. That is, 
the orientation is from the I/O device, not the CPU. 

If bits 7-6 equal 11, then the transfer type is a don’t care value. 

1-0 W CHANNEL SELECT 

00 = Channel 0 selected 

01 = Channel 1 selected 

10 = Channel 2 selected 

11 = Channel 3 selected 

Each DMA channel has a 6-bit mode register. Register selection is 
determined by bits 1 and 0. 
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3 


2 


1 


0 


Request Register (0009H) 

7 6 5 4 



1 

- 1 - 1 - 1 - 

DON'T CARE 

III 

REQUEST 

BIT 

CHANNEL SELECT 

1 

Bit 

R/W 

Description 



7-3 

W 

DON’T CARE (any value! 



2 

w 

REQUEST BIT 

0 = Reset the indicated request bit 

1 = Set the indicated request bit 



1-0 

w 

CHANNEL SELECT 

00 = Channel 0 

01 = Channel 1 

10 = Channel 2 

11 = Channel 3 




The DMA controller responds to requests for DMA service from both software 
and the DMA request signal. Each channel has a request bit that can be set or 
reset as determined by the Request register. These bits are not maskable and 
are subject to prioritization. 
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Status Register (0008H) 

7 6 5 4 3 2 


-1-1-1- 

DMA REQUEST PENDING 

- 1 -,-,- 

TERMINAL COUNT REACHED 

CHANNEL CHANNEL CHANNEL CHANNEL 

CHANNEL CHANNEL CHANNEL CHANNEL 

3 2 10 

_1_1_1_ 

3 2 10 

_1_1_1_ 


Bit R/W Description 

7-4 R DMA REQUEST PENDING 

0 = Indicated channel does not have a request pending 
(CHANNEL 3-0> 

1 = Indicated channel has a request pending (CHANNEL 3-0) 

3-0 R TERMINAL COUNT REACHED 

0 = Indicated channel has not reached the terminal count 
(CHANNEL 3-0) 

1 = Indicated channel has reached the terminal count or external 
EOP applied (CHANNEL 3-0) 

Temporary Register (000CH) 

76543210 


J_I_I_I_I_I_l 


Bit R/W Description 

7-0 R Last data byte transferred in a memory-to-memory transfer 

Between the read and write cycles of a memory-to-memory transfer, the DMA 
controller stores the source byte in this register. This register is cleared by a 
hardware reset or a master clear. 
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Programming Example 

The following programming example demonstrates: 

• Initializing the 8237A DMA controller 

• Enabling and disabling a channel 

• Preparing a channel for data transfer 


The example provides routines as described in the following list: 


dma_init 
dmaopen 
dma_transfer 
dma close 


Resets the DMA controller. 

Enables the indicated DMA channel. 

Prepares the indicated channel for data transfer. 
Disables the indicated channel. 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


Constant Values 

The constant values DMA_PAGEO through DMA_PAGE3 define the I/O ad¬ 
dress of the indicated page register. The values CHANNELO through 
CHANNELl define the channel select bit values for the mode, mask, and 
request registers. The values MTM_ENA through BITJSET define the bit 
values for various conditions of the command, status, mode, and request 
registers. 


/$*$&*$*$************$*$***H<*$*********Hc*9|e***3|e9|c$*)i'’ic*****9|t9l'*’|c’l'*’l')|t$$’l'*’l'’l'9|e’l'/ 

/* define constants used in 8237 DMA example */ 

/*********************************************$**********************$*$:/ 


#define 

DMA_PAGEO 

0x83 

/* 

#define 

DMA_PAGE1 

0x80 

/* 

#define 

DMA_PAGE2 

0x81 

/* 

#define 

DMA_PAGE3 

0x82 

/* 

#define 

CHANNELO 

0x00 


#define 

CHANNELl 

0x01 


#define 

CHANNEL2 

0x02 


#define 

CHANNEL3 

0x03 



DMA page register 0 I/O address */ 
DMA page register 1 I/O address */ 
DMA page register 2 I/O address */ 
DMA page register 3 I/O address */ 

/* select channel 0 bit value */ 
/* select channel 1 bit value */ 
/* select channel 2 bit value */ 
/* select channel 3 bit value */ 
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/* command register bit 

definitions */ 




#define 

MTMJ5NA 

0x01 





/* Memory-to-memory enable 

*/ 

#define 

HOLD.ENA 0x02 



/* , 

channel 0 hold address enable 

*/ 

#define 

DMA.DIS 

0x04 





/* dma controller disable 

*/ 

#define 

C.TIME 

0x08 





/* compressed timing 

*/ 

#define 

ROT.PRI 

0x10 





/* rotating priority 

*/ 

#define 

EXTD_WR 

0x20 





/* extended write 

*/ 

#define DREQ.LO 

0x40 





/* DREQ active when low */ 

#define 

DACK_HI 

0x80 





/* DACK active when high 

*/ 

/* status register bit definitions */ 




#define 

CH0_TC 

0x01 


/* 

channel 

0 

has reached terminal count 

*/ 

#define 

CH1_TC 

0x02 


/* 

channel 

2 

has reached terminal count 

*/ 

#define 

CH2_TC 

0x04 


/* 

channel 

3 

has reached terminal count 

*/ 

#define 

CH3_TC 

0x08 


/* channel 

4 

has reached terminal count 

*/ 

#define 

CH0_REQ 

0x10 



/* 

channel 0 requesting service 

*/ 

#define 

CH1.REQ 

0x20 



/* 

channel 1 requesting service 

*/ 

#define 

CH2.REQ 

0x40 



/* 

channel 2 requesting service 

*/ 

#define 

CH3_REQ 

0x80 



/* 

channel 3 requesting service 

*/ 

/* mode 

register 

bit definitions 

*/ 




#define 

TRAN.VR 

0x00 





/* verify transfer 

*/ 

#define 

TRAN_WR 

0x04 





/* write transfer 

*/ 

#define 

TRAN_RD 

0x08 





/* read transfer 

*/ 

#define 

AUT0_IE 

0x10 





/* auto-initialize enable 

*/ 

#define 

ADR.DEC 

0x20 





/* address decrement 

*/ 

#define 

M0DE_DM 

0x00 





/* demand mode 

*/ 

#define 

M0DE__SI 

0x40 





/* single mode 

*/ 

#define 

M0DE_BK 

0x80 





/* block mode 

*/ 

#define 

M0DE_CS 

OxCO 





/* cascade mode 

*/ 

/* request register bits 

*/ 






#define 

BIT_SET 0x04 





/* set selected mask bit 

*/ 
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Data Structures 

The structure DMAjCHANNEL resembles the I/O space of the address and 
word count registers for a channel. Multiple instances of this structure are used 
in the declaration of the DMA CONTROLLER structure. The 
DMA CONTROLLER structure defines the I/O space of DMA controller inter¬ 
nal registers. The value DMA BASE defines the base address for referencing 
the structure DMA CONTROLLER. 

/* declare structures used in 8237 DMA example */ 


typedef struct /* define dma channel I/O structure */ 

unsigned char bc_addr; /* write base address, read current address */ 

unsigned char bc_word; /* write base word, read current word */ 

> DMAJCHANNEL; 


typedef struct /* define dma controller I/O structure */ 

{ 


DMAjCHANNEL chO; 

DMA_CHANNEL chi; 

DMAjCHANNEL ch2; 

DMAjCHANNEL ch3; 

unsigned char csr; 

unsigned char req; 

unsigned char wsmb; 

unsigned char mode; 

unsigned char temp;/* write clears 

unsigned char master_clr; 

unsigned char clr_mask; 

unsigned char wr_mask; 

> DMAjCONTROLLER; 


/* channel zero registers */ 
/* channel one registers */ 
/* channel two registers */ 
/* channel three registers */ 
/* write control, read status */ 
/* write request register */ 
/* write single mask bit */ 
/* write mode register */ 
e pointer flip-flop, read temp */ 
/* write master clear/reset */ 
/* clear all mask bits */ 
/* write all mask bits */ 


#define DMA.BASE (DMA.CONTROLLER *)0x0000 


/* base address */ 
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Initializing the DMA Controller 

The DMA controller is initialized by issuing a MASTER CLEAR instruction. 
This clears all bits in the command register and effectively disables the control¬ 
ler. The second instruction, which explicitly clears the control register, ensures 
that the controller is disabled. 

/j|e:|e:|c3|e:|c$3k*******4c:|e*9|c3|e3|e4c***$*****$******)|c*9ic*9i'9|c*$$9i(9|c:|(9|'9|c3|c:|c3|cj|e9|e9|c3|c9|e3|e3|ej|c3|e**9|c9ic’ic)|c’|t9|c/ 

/* dma_init() - initialize the 8237 DMA controller */ 

dma_init() 

{ 

DMA.CONTROLLER *pdc = DMA.BASE; 

outp(Apdc->master_clr, 0); 
outp(Apdc->csr, 0); 

} 


/* point to DMA controller */ 

/* reset DMA controller */ 
/* all command register bits to 0 */ 
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Opening a DMA Channel 

The dmajopen function assumes that the channel is currently disabled. It 
writes valid values to the registers that control the indicated channel. 

For this C compiler, offset 0 in the data segment is used only for monitoring 
NULL pointers. With a zero word count, an inadvertent data transfer can move 
only one byte before expiring. 

The last instruction enables the indicated channel. 


/* dma.open() - open a DMA channel */ 

/********************************************sk**************************/ 


dma_open(channe1) 

int channel; /* which DMA channel to open */ 


DMA.CONTROLLER *pdc = DMA_BASE; 
DMA_CHANNEL *pch; 
int i; 


/* point to DMA controller */ 
/* pointer to a channel structure */ 
/* loop control */ 


for(i = channel, pch = Apdc 
pch++; 

outp(&pdc->mode, channel); 
outp(Apdc->req, channel); 
outp(&pdc->temp, 0); 
outp(fcpch->bc_addr, 0); 
outp(&pch->bc_addr, 0); 
outp(Apdc->temp, 0); 
outp(&pch->bc_word, 0); 
outp(Apch->bc_word, 0); 
outp(&pdc->wsmb, channel); 


->chO; i; i—) 


/* discover which channel */ 
/* point to next channel */ 
/* clear mode register for this channel */ 
/* clear channel request for this channel */ 
/* clear first/last flip-flop */ 
/* write 0 to low byte */ 
/* write 0 to high byte */ 
/* clear first/last flip-flop */ 
/* write 0 to low byte */ 
/* write 0 to high byte */ 
/* clear mask bit for this channel */ 
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Preparing a Channel for Data Transfer 

The dma transfer function prepares a channel for data transfer. Next, the func¬ 
tion disables the channel. It then initializes the page, address, word count, and 
mode registers. 

NOTE 

Before writing a 16-bit register, the byte pointer flip/flop must 
be cleared. This sequence loads the two sequential bytes in the 
correct locations. Because interrupt processing could disrupt the 
process, the dmajransfer function disables CPU interrupts 
before clearing the byte pointer flip/flop. Interrupts are not 
enabled until after the 16-bit registers have been written. 


/* dma.transfer() - set parameters for a DMA transfer */ 


dma_transfer(channel, page.val, addr, count, ttype) 


int channel; 
int page.val; 
unsigned char *addr; 
unsigned int count; 
int ttype; 

i 

DMA.CONTROLLER *pdc = DMA_BASE; 
DMA.CHANNEL * pc h; 
unsigned int page.reg; 
int ch.mode; 
int intr.flag; 

switch(channel) 

case 0: 

pch = &pdc->ch0; 
page.reg = DMA.PAGE0; 
ch.mode = 0; 
break; 


/* transfer on which DMA channel ? */ 
/* page register contents */ 
/* transfer address */ 
/* count to transfer */ 
/* transfer type */ 

/* point to DMA controller */ 
/* pointer to a channel structure */ 
/* which page register to write */ 
/* channels mode */ 
/* to hold CPU IF state */ 

/* which channel ? */ 


/* channel 0 ? */ 
/* point to channel 0 registers */ 
/* set page register address */ 
/* auto-initialize k increment/decrement */ 
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case 1: 

pch = &pdc->chl; 
page.reg = DMA.PAGEl; 
ch.mode = 0; 
break; 


/* channel 1 ? */ 
/* point to channel 1 registers */ 
/* set page register address */ 
/* auto-initialize k increment/decrement */ 


case 2: 

pch = &pdc->ch2; 
page.reg = DMA.PAGE2; 
ch_mode = M0DE_SI; 
break; 


/* channel 2 ? */ 
/* point to channel 2 registers */ 
/* set page register address */ 
/* auto-initialize k increment/decrement */ 


case 3: 

pch = &pdc->ch3; 
page_reg - DMA_PAGE3; 
ch.mode = 0; 
break; 


/* channel 3 ? */ 
/* point to channel 3 registers */ 
/* set page register address */ 
/* auto-initialize k increment/decrement */ 


outp(&pdc->wsmb, BIT.SET | channel);/* set mask bit for this channel */ 
outp(ftpdc->req, channel); /* clear channel request for this channel */ 
outp(Apdc->mode, ttype | ch.mode | channel); /* set mode register */ 
intr.flag = int.offQ; /* no interrupts please */ 


outp(&pdc->temp, 0) 
outp(&pch->bc_addr, 
outp(&pch->bc.addr, 
outp(&pch->bc_word, 
outp(&pch->bc.word, count >> 8); 
int.on(intr.flag); 
outp(page.reg, page.val); 
outp(&pdc->wsmb, channel); 


/* clear first/last flip-flop */ 


(unsigned int)addr k Oxff); 
(unsigned int)addr » 8); 
count k Oxff); 


/* 


/* write low byte */ 
/* write high byte */ 
/* write low byte */ 
/* write high byte */ 
/* allow interrupts */ 
/* write the page register */ 
clear mask bit for this channel */ 
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Disabling a DMA Channel 

The dmajclose function closes the channel by masking (disabling) that chan¬ 
nel’s request input line. 

/* dma_close() - close a DMA channel */ 

dma_close(channel) 

unsigned char channel; /* which DMA channel to close */ 

{ 

DMA_CONTROLLER *pdc * DMAJBASE; /* point to DMA controller */ 

outp(Apdc->wsmb, BIT_SET I channel);/* set mask bit for this channel */ 

> 
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Chapter 5 
Real-Time Clock 
and CMOS RAM 


Overview 

The VAXmate processor board contains an MC146818 real-time clock. The real¬ 
time clock has the following features: 

• Time-of-day clock with alarm and 100-year calendar 

• Counts seconds, minutes, and hours of the day 

• Counts days of the week, days of the month, month, and year with auto¬ 
matic end-of-month and leap year recognition 

• Binary or binary-coded-decimal (BCD) representation of date, time, and 
alarm (the ROM BIOS and MS-DOS use BCD). 

• 24-hour clock or 12-hour clock with a.m./p.m. indication 

• Daylight savings time option 

• Internal time base and oscillator 

• External time base 32.768 KHz crystal 

• 64 byte, low-power, static RAM (14 bytes of registers and 50 bytes of 
general purpose RAM) 

• Square wave generator 

• Programmable interrupts 

- Time-of-day alarm, once-per-second to once-per-day 

- Periodic interrupt rates from 30.5 fis to 500 ms 
End-of-update interrupt 
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Additional Source of Information 

The following Motorola Inc. document provides additional information on pro¬ 
gramming the real-time clock. 

• 8-Bit Microprocessor & Peripheral Data 

Battery-Backup Considerations 

To keep time and maintain RAM when system power is off, the real-time clock 
requires a battery-backup source. The two lithium batteries in the VAXmate 
expansion box provide the only battery power source. 

NOTE 

The lithium battery used in the VAXmate expansion box has an 
operational life expectancy of 6 years and a shelf life of 10 
years. 

Addressing the Real-Time Clock 

The real-time clock (RTC) is addressed by the contents of an 8-bit latch at I/O 
port 0070H and the RTC data is read or written through I/O port 0071H. 

NOTE 

The RTC address latch is write only. Bit 7 of the RTC address 
latch (I/O port 0070H) is the nonmaskable interrupt (NMI) mask 
register. If bit 7 equals zero, the NMI is enabled. Otherwise, the 
NMI is disabled. For more information about the nonmaskable 
interrupt, see Chapters 3 and 15. 

The RTC dedicates the first 14 bytes of RAM (00H through ODH) as registers 
for the real-time clock functions. The remaining 50 bytes of RAM (OEH 
through 3FH| are not dedicated to the RTC. Table 5-1 describes the RTC ad¬ 
dress map. 
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Table 5-1 Real-Time Clock Address Map 


Latch Value 

R/W 

Location Accessed 

00H 

R/W 

Seconds register 

01H 

R/W 

Seconds alarm register 

02H 

R/W 

Minutes register 

03H 

R/W 

Minutes alarm register 

04H 

R/W 

Hours register 

05H 

R/W 

Hours alarm 

06H 

R/W 

Day-of-week register 

07H 

R/W 

Day-of-month register 

08H 

R/W 

Month register 

09H 

R/W 

Year register 

OAH 

R/W 

Register A 

OBH 

R/W 

Register B 

OCH 

R/W 

Register C 

ODH 

R/W 

Register D 

0EH-3FH 

R/W 

Remaining 50 bytes of RTC RAM * 


* See the definition of the structure RTC in the programming example. 


Real-Time Clock Registers 

The real-time clock (RTC) has two types of registers: 

• Data (locations 00H through 09H) 

• Control and status (locations OAH through ODH) 

Data registers are valid only when the RTC is not updating. During clock up¬ 
dates, the RTC disconnects the data registers from the RTC bus. The specifics 
of data register processing are discussed later. 

The control and status registers are available at all times. 
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Register A 

Addressing - Write OAH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7654 3 210 



DIVIDER SELECTION BITS 

l-1 l- 

RATE SELECTION BITS 

UIP 




DS2 | DS1 | DS0 

RS3 | RS2 | RSI | RS0 


Bit R/W Description 


7 R/W UIP - Update In Progress 

0 = For all time bases, at least 244 /us remain before the update 
cycle begins. The data registers are available for reading. 

1 = Update cycle is in progress or begins in less then 244 /us. 

The UIP bit is a read-only bit. For the 32.768 KHz time base, the 
update cycle time is 1984 /us. Writing a 1 to the Register B SET 
bit inhibits the update cycle and clears the UIP status bit. A hard¬ 
ware reset does not modify the UIP bit. 

6-4 R/W DIVIDER SELECTION BITS 

These bits identify the time base to use. Writing 111 to these bits 
resets the divider. One second after removing the divider reset, the 
first update cycle begins. For the VAXmate workstation time base 
of 32.768 KHz, set these bits to 010. A hardware reset does not 
modify the DIVIDER SELECTION bits. 

3-0 R/W RATE SELECTION BITS 

These bits select one of 15 taps on a 22-stage divider or disable 
the divider. Table 5-2 shows the bit values for the possible inter¬ 
rupt rates. A hardware reset does not modify the RATE 
SELECTION bits. On powerup, the ROM BIOS sets these bits to 
0 . 
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Table 5-2 Rate Selection Bits 


RS3 

RS2 

RSI 

RSO 

Periodic Interrupt Rate 

0 

0 

0 

0 

None (divider disabled) 

0 

0 

0 

1 

3.90625 n s 

0 

0 

1 

0 

7.8125 ns 

0 

0 

1 

1 

122.070 ns 

0 

1 

0 

0 

244.141 ns 

0 

1 

0 

1 

488.281 ns 

0 

1 

1 

0 

976.562 ns 

0 

1 

1 

1 

1.953125 ms 

1 

0 

0 

0 

3.90625 ms 

1 

0 

0 

1 

7.8125 ms 

1 

0 

1 

0 

15.625 ms 

1 

0 

1 

1 

31.250 ms 

1 

1 

0 

0 

62.5 ms 

1 

1 

0 

1 

125.0 ms 

1 

1 

1 

0 

250.0 ms 

1 

1 

1 

1 

500.0 ms 
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Register B 

Addressing - Write OBH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 

6 

5 

4 

3 

2 

1 

0 

SET 

PIE 

AIE 

UIE 

SQWE 

DM 

HM 

DSE 


Bit R/W Description 


7 


6 


5 


4 


3 


R/W SET 

0 = Allow update cycles to occur once per second 
1 = Abort any update cycle in progress and inhibit update cycles 
until cleared. (This allows initialization of the date, time, and 
alarm registers.) 

A hardware reset does not modify the SET bit. 

R/W PIE - Periodic Interrupt Enable 

0 = Disable periodic interrupts (default value) 

1 = Enable periodic interrupts at the rate specified by RS3-RS0 
in Register A 

A hardware reset clears the PIE bit to 0. 

R/W AIE - Alarm Interrupt Enable 

0 = Disable alarm interrupts (default value) 

1 = Enable alarm interrupts. (The interrupt frequency depends on 
the contents of the alarm registers.) 

A hardware reset clears the AIE bit to 0. 

R/W UIE - Update-ended Interrupt Enable 

0 = Disable the update-ended interrupt (default value) 

1 = Enable the update-ended interrupt 

A hardware reset or setting the register B SET bit clears the UIE 
bit to 0. 

R/W SQWE - Square Wave Enable 

0 = Disable the square-wave output (default value) 

1 = Enable the square-wave output 

The square-wave output is not connected to anything, so the 
SQWE bit should always be written as 0. A hardware reset clears 
the SQWE bit to 0. 
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Bit R/W Description (Register B - cont.) 


2 


1 


0 


R/W DM - Data Mode 

0 = Binary-coded-decimal (BCD) data format used for date, time, 
and alarm registers 

1 = Binary data format used for date, time, and alarm registers 

A hardware reset does not modify the DM bit. However, the ROM 

BIOS clears DM to 0. 

R/W HM - Hour Mode 

0 = Hours register and hours alarm register use a 12-hour clock 
with a.m. or p.m. indication 

1 = Hours register and hours alarm register use a 24-hour clock 

A hardware reset does not modify the HM bit. However, the ROM 

BIOS sets HM equal to 1. 

R/W DSE - Daylight Savings Enable 

0 = Disable daylight savings 

1 = Enable daylight savings. Daylight savings changes occur at 2 
a.m. on the last Sunday in April and the last Sunday in 
October. 

A hardware reset does not modify the DSE bit. However, the 

ROM BIOS clears DSE to 0. 


Real-time Clock and CMOS RAM - Hardware Description 


5- 7 





Register C 

Addressing - Write OCH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 

6 

5 

4 

3 

2 

1 

0 

IRQF 

PIF 

AIF 

UIF 

0 

0 

0 

0 


Bit R/W Description 


7 R/W IRQF - Interrupt Request Flag 

When one or more of the following conditions are true, the RTC 
sets the IRQF bit to 1: 

PIF = PIE = 1 
AIF = AIE = 1 
UIF = UIE = 1 


6 


5 


4 


3-0 


R/W PIF - Periodic Interrupt Flag 

When register B, bit PIE equals 1, the PIF bit indicates the state 
of the periodic interrupt. If PIF equals 1, the RTC sets IRQF. 
Register A bits RS3-RS0 establish the rate of this interrupt. 

R/W AIF - Alarm Interrupt Flag 

When register B, bit AIE equals 1, the AIF indicates the state of 
the alarm interrupt. When AIF equals 1, the current time matches 
the alarm time and the RTC sets IRQF. 

R/W UIF - Update-ended Interrupt Flag 

When register B, bit AIE equals 1, the UIF bit indicates the state 
of the update-ended interrupt. At the end of each update cycle, the 
RTC sets this bit to 1 and sets IRQF. 

R/W Always 0 


Resetting hardware or reading register C clears all bits in register C. Writing 
to Register B does not modify the bits in Register C. 


5-8 Real-time Clock and CMOS RAM - Hardware Description 














Register D 

Addressing - Write ODH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 

6 

5 

4 

3 

2 

1 

0 

VRT 

0 

0 

0 

0 

0 

0 

0 


Bit R/W Description 

7 R/W VRT - Valid RAM and Time 

0 = Since the last time this register was read, the power-sense 
circuitry detected a loss of power to the RTC. The RTC reg¬ 
isters and RAM contain invalid data. 

1 = Since the last time this register was read, power to the RTC 
has remained stable. 

Reading this register sets the VRT bit. It is the only way to set 
the VRT bit. After setting the date, time, or alarm, read this regis¬ 
ter so that the VRT bit indicates that the registers are valid. 

A hardware reset does not modify the VRT bit. 


6-0 R/W Always 0 
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Real-Time Clock Data Registers 

The real-time clock (RTC) formats the date and time in either binary or binary- 
coded-decimal (BCD). All data registers. (OOH through 09H) must use the same 
format. If the data format is changed, the data registers must be initialized in 
the new format. The ROM BIOS uses the BCD data format. Bit 2 of register 
B controls the format. 

The HOUR MODE bit in Register B controls the range of the hour and hour 
alarm registers. When the HOUR MODE bit is set (1), the hour and hour 
alarm registers have the range 0-23. When the HOUR MODE bit is clear (0), 
the hour and hour alarm registers have the ranges 1-12 (a.m.) and 129-140 
(p.m.). 

The hours, minutes, and seconds alarm registers have an additional range of 
COH-FFH. This is an alarm register don’t care code. For more information, see 
the alarm description. Table 5-3 shows the format and ranges of the data 
registers. 
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Table 5-3 RTC Data Register Ranges 


Latch 

Value 

Register 

Function 

Binary Range 

BCD Range 

00H 

Seconds 

All modes 

0-59 

00H-59H 

01H 

Seconds 

Alarm 

Specific time 

0-59 

00H-59H 



Each second 

192-255 

C0H-FFH 

02H 

Minutes 

All modes 

0-59 

00H-59H 

03H 

Minutes 

Alarm 

Specific time 

0-59 

00H-59H 



Each minute 

192-255 

C0H-FFH 

04H 

Hours 

24-hour mode 

0-23 

00H-23H 



12-hour mode a.m. 

1-12 

01H-12H 



12-hour mode p.m. 

129-140 

81H-92H 

05H 

Hours Alarm 

Specific time 
(24-hour mode) 

0-23 

00H-23H 



Specific time (12-hour 
mode a.m.) 

1-12 

01H-12H 



Specific time (12-hour 
mode p.m.) 

129-140 

81H-92H 



Each hour (all modes) 

192-255 

C0H-FFH 

06H 

Day-of-Week 


1-7 

01H-07H 

07H 

Day-of-Month 


1-31 

01H-31H 

08H 

Month 


1-12 

01H-12H 

09H 

Year 


0-99 

00H-99H 
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Alarms 

During each real-time clock (RTC) update cycle, the RTC compares the hour, 
minute, and second registers to the corresponding alarm registers. If all of the 
time registers match all of the alarm registers, the RTC sets the register C 
AIF. If, when this occurs, the register B alarm interrupt enable (AIE) bit is 
enabled, the alarm interrupt triggers IRQ8. 

An alarm register value in the range COH-FFH is a don’t care code. When an 
alarm register contains a don’t care code, that alarm register matches any 
value in the corresponding time register. 

Table 5-4 shows the eight different types of automatic alarm cycles provided by 
the real-time clock (RTC). 


Table 5-4 RTC Automatic Alarm Cycles 


Cycle Description 

Hour Alarm 

Minute Alarm 

Second 

Alarm 

Once per second every second 

COH-FFH 

COH-FFH 

COH-FFH 

Once per second for a 
one-minute span every hour 

COH-FFH 

Specified 

COH-FFH 

Once per second for a one- 
minute span every 24 hours 

Specified 

Specified 

COH-FFH 

Once per second for a one-hour 
span every 24 hours 

Specified 

COH-FFH 

COH-FFH 

Once per minute every minute 

COH-FFH 

COH-FFH 

Specified 

Once per minute for a one-hour 
span every 24 hours 

Specified 

COH-FFH 

Specified 

Once per hour every hour 

COH-FFH 

Specified 

Specified 

Once every 24 hours 

Specified 

Specified 

Specified 


Also, there is a nonautomatic way to use the alarm function. To use this 
method, set a specific alarm time. At each subsequent alarm interrupt, set the 
next specific alarm time. 
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Update Cycle 

Once per second, the real-time clock (RTC) performs an update cycle. With a 
32.768 KHz time base, the update cycle requires 1948 (is. The update cycle 
comprises the following steps: 

• The RTC sets (1) the register A UIP bit. 

• After 244 yus, the RTC disconnects the data registers from the external 
bus and connects them to the internal bus. 

• The RTC increments the seconds register. 

• The RTC checks for an overflow condition. If no overflow condition exists, 
the RTC goes to the next step. Otherwise, the RTC zeros the register 
and increments the next register in the series. 

• The RTC compares the hour, minute, and seconds registers to the cor¬ 
responding alarm registers. If a match occurs for all three registers, the 
RTC sets (1) the register C alarm flag (AIF). 

• The RTC disconnects the data registers from the internal bus and con¬ 
nects them to the external bus. 

• The RTC clears (0) the register A UIP bit. 

• The RTC sets (1) the register C update-ended interrupt flag (UIF) 


During an update cycle, the data registers are disconnected from the external 
bus. Therefore, while an update is in progress, reading or writing a data regis¬ 
ter produces invalid results. Use one of the following methods to avoid update 
cycles: 


• Monitor the register A update-in-progress (UIP) bit. The update cycle 
begins 244 (is after the RTC sets the UIP bit. Thus, if the UIP bit is 
clear, the data registers will remain valid for at least 244 (is. 

• Enable the update-ended interrupt. This interrupt occurs after every 
update cycle. The date and time registers remain valid for over 999 ms 
after the RTC sets the UIF. If the processor must handle an excessive 
amount of interrupts, the interrupt handler for the RTC should also moni¬ 
tor the UIP bit. 

• Monitor the register C periodic interrupt flag (PIF). The periodic interrupt 
is synchronized with the update cycle. For any given periodic interrupt, 
there is a time after the interrupt when the data registers are valid. For a 
32.768 KHz time base, use only the rates between 3.90625 ms and 500 
ms. Use the following formula to calculate the valid time span: 

Time Span = 244 (is + (RATE / 2) 
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Interrupts 

Periodic Interrupt 

If the PIE bit is set (1), the periodic interrupt triggers IRQ8 at the rate speci¬ 
fied by the RATE SELECT bits in register A. 

Update-Ended Interrupt 

If the UIE bit is set (1), the update-ended interrupt triggers IRQ8 once per 
second. The next RTC update cycle starts 1000 ms after the update-ended 
interrupt. 

Alarm Interrupt 

During each RTC update cycle, the RTC compares the hour, minute, and 
second registers to the corresponding alarm register. If the time and alarm reg¬ 
isters match and if the AIE bit is set (1), the alarm interrupt triggers IRQ8. 
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Programming Example 

The real-time clock (RTC) programming example demonstrates: 

• Reading and writing the RTC registers and RAM 

• Handling RTC interrupts 

• Interpreting the data stored in the RTC RAM 

• Calculating the checksum that ensures data integrity 


The next programming example provides the following routines: 


rdrtc 

wr_rtc 

rtc_cksum 

btb 

bed 

rddate 

rd_time 

shw_date 

shw^time 

shwddtyp 

shwjidtyp 

rtc_int_hand 

shwhdw 

rtcinit 

rtcrest 

rtc 


Reads the indicated RTC register or RAM location 

Writes the indicated RTC register or RAM location 

Returns the calculated RTC RAM checksum 

Returns the binary equivalent of a binary-coded decimal 
(BCD) value 

Returns the binary-coded decimal (BCD) equivalent of a 
binary value 

Reads the date-related registers and stores the results in 
the indicated structure 

Reads the time-related registers and stores the results in 
the indicated structure 

Displays the current date at location 0,0 

Displays the current time at location 0,72 

Displays the diskette drive types 

Displays the hard disk drive types 

Handles hardware interrupts from the RTC 

Displays the hardware setup from RTC RAM 

Initializes the RTC interrupt vector (70H) and the RTC 
alarm registers 

Restores the RTC interrupt vector (70H) and disables clock 
interrupts 

Provides menu selection of the examples and executes the 
examples 
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CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the next programming example is limited to the context pro¬ 
vided in this manual. No other use is intended. 

Constant Values 

The file ( kyb.h) that is included defines constant values for function keys. See 
Chapter 8 for information about keyboard programming. 

The file {example.h) that is included defines the structure type MESSAGE that 
is used to display the menu. 

The constant values CKSUM_START and CKSUM_END define the start and 
end offsets of the RTC RAM that is under checksum control. If any value in 
this range is changed, a new checksum must be written to reflect this change. 

The constant values UIP through VRT define bit values for registers A through 
D. The value DIVIDE SEL defines the divider that divides the base input fre¬ 
quency for the internal ETC operation. This value is related to the VAXmate 
hardware design and should be considered a fixed value. 
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#include "kyb.h" 
#include ,, example.h ,, 


/* reference function key constants */ 
/* reference menu structure */ 


/* define constants used in RTC example */ 


#define CKSUM_START 0x10 
#define CKSUM.END 0x20 

/* define register A bit values */ 

#define UIP 0x80 

#define DIVIDE.SEL 0x20 
#define RATE_SEL OxOd 

/* define register B bit values */ 

#define SET.UPD 0x80 

#define PIE 0x40 

#define AIE 0x20 

#define UIE 0x10 

#define SQWE 0x08 

#define DAT_M0D 0x04 

#define CLK24 0x02 

#define DSE 0x01 

/* define register C bit values */ 

#define IRQF 0x80 

#define PIF 0x40 

#define AIF 0x20 

#define UIF 0x10 

/* define register D bit values */ 

#define VRT 0x80 


/* offset of start of checksum area */ 
/* offset of end of checksum area */ 


/* disable updating of date k time */ 
/* Periodic Interrupt Enable */ 

/* Alarm Interrupt Enable */ 

/* Update-Ended Interrupt Enable */ 

/* Square Wave Enable */ 

/* Data mode (BCD = 0, Binary = 1) */ 
/* 12-hour clock = 0, 24 hour = 1 */ 
/* Daylight Sayings Enable */ 


/* Interrupt Request Flag */ 
/* Periodic Interrupt Flag */ 
/* Alarm Interrupt Flag */ 
/* Update-Ended Flag */ 


/* Valid Ram k Time bit */ 


/* update in progress bit */ 
/* FIXED VALUE - Hardware related */ 
/* Programmer defined interrupt rate */ 
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Data Structures 

The structure type RTC defines the I/O space that accesses the real-time clock. 
The offset within the real-time clock (00H-3FH) is written to an 8-bit latch that 
addresses the real-time clock. This latch is located at I/O address 0070H. Data 
is read or written through I/O address 0071H. 

The structure type CMOS defines how each RAM location is used within the 
real- time clock. The real-time clock dedicates the first 14 locations as regis¬ 
ters. The remaining 50 bytes of RAM are defined according to industry- 
standard usage. 

The structure type DATIM provides a consistent format for moving date and 
time information. 


/* declare structures used in RTC example */ 


typedef struct 

unsigned char addr.port; /* write RTC/CMOS address to this port */ 
unsigned char data.port; /* read/write data through this port */ 

> RTC; 


typedef struct 


unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 


char seconds; 
char alr.sec; 
char minutes; 
char alr.min; 
char hours; 
char alr.hr; 
char dow; 
char dom; 
char month; 
char year; 
char rega; 
char regb; 
char regc; 
char regd; 
char diag; 
char reset; 
char ddtyp; 
char reservl; 
char hdtyp; 
char reserv2; 


/* seconds (0-59) current time */ 
/* seconds alarm */ 
/* minutes (0-59) current time */ 
/* minutes alarm */ 
/* hours (0-11/23) current time */ 
/* hours alarm */ 
/* day-of-week (1-7) */ 

/* day-of-month (1-28/29/30/31) */ 
/* month (1-12) current date */ 
/* year (0-99) current date */ 
/* register A */ 
/* register B */ 
/* register C */ 
/* register D */ 
/* diagnostics byte */ 
/* reason for reset */ 
/* diskette drive type */ 
/* reserved byte */ 
/* hard disk type */ 
/* reserved byte */ 
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unsigned char syscfg; 
unsigned char bmeml; 
unsigned char bmemh; 
unsigned char lememl; 
unsigned char lememh; 
unsigned char reserv3[0x2e - 
unsigned char cksumh; 
unsigned char cksuml; 
unsigned char hememl; 
unsigned char hememh; 
unsigned char century; 
unsigned char info; 
unsigned char reserv4[0x40 - 
> CMOS; 


/* system configuration byte */ 
/* base memory size low byte */ 
/* base memory size high byte */ 
/* expansion memory size low byte */ 
/* expansion memory size high byte */ 
0x19]; /* reserved */ 

/* high byte of checksum (always 0) */ 
/* low byte of checksum */ 
/* expansion memory size low byte */ 
/* expansion memory size high byte */ 
* century byte of date (19 from 1986) */ 

/* information flag */ 

0x34]; /* reserved */ 


typedef struct 

int seconds; 
int minutes; 
int hours; 
int dow; 
int dom; 
int month; 
int year; 

} DATIM; 


/* seconds (0-59) */ 
/* minutes (0-59) */ 
/* hours (0-11/23) */ 
/* day-of-week (1-7) */ 

/* day-of-month (1-28/29/30/31) */ 
/* month (1-12) */ 
/* year (century * 100 + year register) */ 
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Reading the Registers and RAM 

The function rd_rtc reads the indicated byte of real-time clock RAM. Before 
accessing the byte, the offset is compared to the range 00H-09H. This is the 
offset range of the data registers, which are invalid during update cycles. If the 
offset falls within this range, the read is synchronized with the update-in¬ 
progress bit. 

/* rd_rtc() - read an RTC byte (if date or time, monitor UIP bit) */ 

/**H'******N<*******************************************:|'**’f:*’l<*’l'’l'*****’l':*3|(’i'/ 


int rcLrtc(offset) 
int offset; 

{ 


/* read RTC byte */ 
/* byte offset to read */ 


RTC *prtc; 

CMOS *pcmos; 
unsigned int intr_flg; 
unsigned char retval; 


/* ptr to address & data ports */ 
/* ptr to RTC/CMOS structure */ 
/* CPU IF state */ 
/* value to return */ 


prtc = (RTC *)0x70; 
pcmos * 0; 

if (offset < (int)(£pcmos->rega)) 

{ 

while(1) 

{ 

intr_flg = int_off(); 
outp(Aprtc->addr_port, &pcmos->rega) 
if(inp(&prtc->data_port) & UIP) 
int_on(intr_flg); 
else break; 

> 

> 

else intr.flg = int_off(); 
outp(&prtc->addr_port, offset); 
retval = inp(&prtc->data_port); 
int_on(intr_flg); 
return(retval); 


/* assign I/O address */ 
/* structure offset is zero */ 
/* need to monitor UIP ? */ 

/* break out when ready */ 

/* no interrupts allowed */ 
/* set to reg A */ 
/* test UIP bit */ 
/* allow interrupts */ 


/* no interrupts allowed */ 
/* set to desired offset */ 
/* read data */ 
/* allow interrupts */ 
/* return data byte */ 
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Writing the Registers and RAM 

The function wrjrtc writes the indicated byte of real-time clock RAM. Before 
accessing the byte, the offset is compared to the range 00H-09H. This is the 
offset range of the data registers, which are invalid during update cycles. If the 
offset falls within this range, the write is synchronized with the update-in¬ 
progress bit. 


/* wr_rtc() - write an RTC byte */ 

/^ifc*********************************************************************/ 

void wr_rtc(offset, value) /* write RTC byte */ 

int offset; /* offset to write */ 

unsigned char value; /* byte value to write */ 

{ 


RTC *prtc; 

CMOS *pcmo8; 
unsigned int intr_flg; 


/* ptr to address A data ports */ 
/* ptr to RTC/CMOS structure */ 
/* CPU IF state */ 


prtc = (RTC *)0x70; 
pcmos = 0; 

if(offset < (int)(Apcmos->rega)) 

{ 

while(l) 

{ 

intr_flg = int_off(); 
outp(Aprtc->addr_port, &pcmos->rega) 
if(inp(&prtc->data_port) A UIP) 
int_on(intr_flg); 
else break; 

> 

> 

else intr_flg = int_off(); 
outp(Aprtc->addr_port, offset); 
outp(Aprtc->data_port, value); 
int_on(intr_flg); 


/* assign I/O address */ 
/* structure offset is zero */ 
/* need to monitor UIP ? */ 

/* break out when ready */ 

/* no interrupts allowed */ 
/* set to reg A */ 
/* test UIP bit */ 
/* allow interrupts */ 


/* no interrupts allowed */ 
/* set to desired offset */ 
/* write data */ 
/* allow interrupts */ 
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Calculating the Checksum 

The function rtcjcksum calculates the checksum and returns the result to the 
caller. The checksum is the sum, modulo 256, of all bytes in the range 
CKSUM START through CKSUM END. 

/* rtc_cksum() - calculate the CMOS checksum and return its value */ 

unsigned char rtc_cksum() /* calculate the CMOS checksum */ 

int i; /* loop control */ 

unsigned char sum; /* accumulates the checksum */ 

sum =0; /* sum starts out zero */ 

ford = CKSUM_START; i <= CKSUM_END; i++) /* all checksum bytes */ 

sum +* rd_rtc(i); /* read data and add to sum */ 

return(sum); /* return calculated checksum */ 

> 
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Converting Binary-Coded Data 

The ROM BIOS defines the data mode as binary-coded decimal (BCD! and 
therefore, so does this example. This requires converting between BCD and 
binary. The function btb converts a BCD value to its binary equivalent. The 
function bed converts a binary value to its BCD equivalent. 

/*$*:|c$3|c:>|e*9te)|c:i|c:k:fc9|c:lc*:>|c}|c;ie*3ic9ic*****Hc***********************:)|':k***:***’lc*********’l'*/ 

/* btb - convert bed value to binary integer value */ 

/***5tC*********************** + ********** + 4:***5l«3le*****5f:*5l<:******5tC3lC5|c*********/ 

btb(bcd_val) /* bed to binary integer */ 

unsigned char bcd_val; /* bed value */ 

{ /* assume valid bed value */ 

return(((bcd_val » 4) * 10) + (bcd_val k OxOf)); 

> 


/* bed - convert binary value to bed value */ 


unsigned char bcd(val) 
unsigned char val; 


unsigned char tmp; 

tmp = (val / 10) « 4; 
tmp |= val % 10; 
return(tmp); 

> 


/* binary to bed */ 
/* binary value */ 

/* assume valid bed value */ 

/* tens in upper nibble */ 

/* ones in lower nibble */ 

/* return BCD value */ 
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Reading the Date 

The function rdjdate reads all of the date-related registers and stores the 
results in the DATIM structure pointed to by the calling parameter. It can be 
called at any time without restriction. 

The century byte is not a real-time clock register. The century byte is an 
industry-standard location that overcomes the 100-year calendar limitation. It 
must be updated manually or by software. 

/ft**********************************************************************/ 

/* rdLdate() ~ read date and write to DATIM structure */ 

/i|cHc*****Hc***9|e*:fc3k**9k$$*H'************M<**********************’k**:>l'**’l':****)|')k*/ 


void rd.date(pd) 


/* read the date */ 


DATIM *pd; /* where to store data */ 

< 


CMOS *pcmos; 


/* ptr to RTC/CMOS structure */ 


pcmos * 0; 

pd->dow 

pd->dom 

pd->month 

pd->year 

pd->year 


btb(rd_rtc(&pcmos->dow)); 
btb(rd_rtc(Apcmos->dom)); 
btb(rd_rtc(&pcmos->month)); 
btb(rd_rtc(&pcmos->century)) 
btb(rd_rtc(&pcmos->year)); 


structure offset is zero */ 
/* day-of-week */ 
/* day-of-month */ 
/* month */ 
100; /* century */ 

/* year */ 


5-24 Real-time Clock and CMOS RAM - Programming Example 



Reading the Time 

The function rdjime reads all of the time-related registers and stores the 
results in the DATIM structure pointed to by the calling parameter. This func¬ 
tion assumes the use of the 24-hour clock mode. It can be called at any time 
without restriction. 

/s|e$9|cj|c$$3|c$3|c****:|e:ie:ie*3|e3|c:|e3fc:|c3|c9|c*:|c***9|c*****>|e****3k3|c**************3|c3|e**3|e3|c9|c)|e]|e)|c3|e9|c3|e3|e3|c/ 

/* rd_time() - read time and write to DATIM structure */ 

/ft**********************************************************************/ 

void rd_time(pd) /* read the time */ 

DATIM *pd; /* where to store data */ 


CMOS *pcmo8; 


/* ptr to RTC/CMOS structure */ 


pcmos =0; /* 
pd->seconds = btb(rd_rtc(&pcmos->seconds)); 
pd->minutes =* btb(rd_rtc(&pcmos->minutes)); 
pd->hours = btb(rd_rtc(Apcmos->hours)); 


structure offset is zero */ 
/* seconds */ 
/* minutes */ 
/* hours */ 
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Displaying the Date 

The function shwjdate displays the current date starting at row 0 and column 
0. It can be called at any time without restriction. 


/* define some day and month names */ 

/***********************************************************************/ 

char day_name[8][10] = 

{ 

"Invalid" , /* rtc is 1 based */ 

"Sunday" , "Monday", "Tuesday", "Wednesday", 

"Thursday", "Friday", "Saturday" 

>; 


char month__name [13] [10] = 

"Invalid", 

"January" , "February", "March" , 
"May" , "June" , "July" 

"September", "October" , "November", 


/* rtc is 1 based */ 
"April", 

"August", 

"December" 


/* shw_date - show date starting at row 0 column 0 */ 

shw_date() 

{ 

DATIM dt; /* date and time structure */ 

char sdate[50]; /* place to store output */ 

rd_date(&dt); /* read current date */ 

sprintf (sdate, "%9s 8 /,9s °/ 0 2d, °/ 0 O4d" , &day_name [dt. dow] [0] , 

&month_name[dt.month][0], dt.dom, dt.year); 
disp_str(0, 0, sdate); /* display it */ 

> 
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Displaying the Time 

The function shwjime displays the current time starting at row 0 and column 
72. It can be called at any time without restriction. 

/*$*$*$*******$$*******$****** 

/* shw_time - show time on row 0 column (last_column - 7) */ 

shw_time() 

i 

DATIM dt; /* date and time structure */ 

char stime[50]; /* place to store output */ 

rd_time(&dt); /* read current time */ 

sprintf (stime, ,,# / f 2d:%02d:%02d M , dt.hours, dt.minutes, dt.seconds); 
disp_str(0, 72, stime); /* display it */ 

> 
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Displaying the Diskette Drive Type 

The function shw_ddtyp is a text-formatting subroutine that generates the 
diskette drive type according to the calling parameters. It is only called by the 
function shw hdw. 


/**********************************************************ft************/ 

/* shw^ddtyp - show diskette drive type */ 

/***********************************************************************/ 


void shw_ddtyp(pc, ddtyp, drive) 

char *pc; 
char ddtyp; 
char drive; 

< 

int i; 


/* show diskette drive type */ 

/* buffer to write to */ 
/* diskette drive type */ 
/* drive letter */ 


/* temp for index */ 


i = sprintf(pc, "Diskette drive %c is ”, drive); /* general opening */ 
switch(ddtyp) 

i 

case 0: /* no drive */ 

sprintf(Ape[i], "non-existent"); 
break; 


case 1: /* 48 tpi dsdd */ 

sprintf(&pc[i], "48-TPI double sided”); 
break; 


case 2: /* 96 tpi dsdd he */ 

sprintf(&pc[i], "an RX33 96-TPI double-sided, high-capacity”); 
break; 

default: /* unknown type */ 

sprintf(&pc[i], "an unknown type”); 
break; 

> 

> 
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Displaying the Hard Disk Type 

The function shwjidtyp is a text-formatting subroutine that generates the hard 
disk drive type according to the calling parameters. It is only called by the 
function shw_hdw. 

/*^**4c*******S|C***3|C*j|C5|C5|C**5|C******5|C****5|e*****5iC5|t**S|t*>|C5|C*****j|t*3|C*******5|C»|e5le****/ 

/* shw_hdtyp - show hard disk type */ 

/sk**********************************************************************/ 

void shw_hdtyp(pc, hdtyp, drive) /* show hard disk type */ 

char *pc; 
char hdtyp; 
char drive; 

< 

int i; 

i = sprintf(pc, "Hard disk drive ®/,c is ", drive); 

if(hdtyp) sprintf(&pc[i], "type %d", hdtyp); /* drive type */ 

else sprintf(&pc[i], "non-existent”); /* no drive */ 

> 


/* hard disk type */ 
/* drive letter */ 
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Handling the Clock Interrupts 

The function rtc_int_hand is the real-time clock interrupt handler. It checks for 
all of the three possible interrupts, update-ended flag (UIF), alarm flag (AF), 
and periodic interrupt flag (PIF). After handling the interrupts, the interrupt 
handler notifies the interrupt controller. 

The update-ended interrupt occurs once per second. At each interrupt, the in¬ 
terrupt handler increments the global flag, time_flag, to indicate that at least 
one second has elapsed. 

The alarm interrupt is initialized to the first second of every day. At each inter¬ 
rupt, the interrupt handler increments the global flag, date_flag, to indicate 
that at least one day has elapsed. 

The periodic interrupt is initialized to a rate of 125 ms. At each interrupt, the 
interrupt handler increments the global counter, metronome. The 8254 timer 
and speaker example in Chapter 6 uses this counter for output timing. Also, 
the periodic interrupt handler calls unbeep. If required, unbeep turns off the 
bell (beep sound}. The example programs use the speaker to generate a bell 
(beep sound). 
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/* rtc_int_hand() - real-time clock interrupt handler */ 

int time_flag; /* 1 second update flag */ 

int date_flag; /* 1 day update flag */ 

unsigned int metronome; /* timer for sound output */ 

int motor^flag; /* timer for diskette drive motors */ 

int head_settle; /* head settle timer for diskette drives */ 

void rtc_int_hand() /* rtc int handler */ 


CMOS *pcmos; 
unsigned char tmp; 


/* ptr to RTC/CMOS structure */ 
/* temp to read in reg C */ 


pcmos =0; /* structure offset is zero */ 
tmp = rd_rtc(&pcmo8->regc); /* read current interrupt requests */ 
if(tmp k UIF) time_flag++; /* time updates once per second */ 
if(tmp k AIF) date_flag++; /* alarm set for once per day at 00:00:00 */ 
if(tmp k PIF) /* periodic interrupt ? */ 


metronome++; 
unbeep(); 
if(motor_flag) 
if(—motor_flag 
motor_off(); 
if(head_settle) 
head__settle—; 

> 

eoi(l) ; 

> 


/* increment timing for speaker demo */ 
/* unbeep turns off speaker if bell */ 
/* if timing diskette drive motors */ 
0) /* if timed out */ 

/* call routine to turn motors off */ 
/* if timing head settle */ 
/* reduce count */ 

/* end of interrupt for interrupt controller */ 
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Interpreting the RAM Contents 

The function shwjidw interprets the industry-standard locations in the real¬ 
time clock RAM and displays the results. The ROM BIOS interprets this data 
in the same manner. 

/* Bh.JidwO - show hardware setup in CMOS */ 

sh_hdw() 

{ 

unsigned char tmp; 
unsigned int ui; 

CMOS *pcmos; 
char *pc; 
char line[512]; 

#define ROW 16 
#define COL 17 

pcmos =0; /* structure offset is zero */ 

tmp = rd_rtc(&pcmos->8yscfg); /* read system config */ 

sprintf(line, "%d diskette drive(s) present", (tmp >> 6) + 1); 
disp_str(ROW, COL, line); 

switch((tmp & 0x30) » 4) /* check video type */ 

case 0: /* not a valid type */ 

pc = "Invalid video type"; 
break; 

case 1: 

pc = "40 column color graphics"; 
break; 

case 2: 

pc = "80 column color graphics"; 
break; 

case 3: 

pc = "Monochrome adapter with parallel port"; 
break; 

> 

disp_str(ROW + 1, COL, pc); /* display video type */ 

tmp = rd_rtc(&pcmos->ddtyp); /* read diskette drive types */ 
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/* to hold CMOS byte read */ 
/* to hold memory size */ 
/* ptr to RTC/CMOS structure */ 



shw_ddtyp(line, tmp » 4, 'A'); 
disp_str(ROW + 2, COL, line); 
shw_ddtyp(line, tmp k OxOf, *B’); 
disp_str(ROW + 3, COL, line); 
tmp = rd_rtc(&pcmos->hdtyp); 
shw_hdtyp(line, tmp >> 4, *C*); 
disp_str(ROW + 4, COL, line); 
shw_hdtyp(line, tmp k OxOf, * D *); 
disp_str(ROW + 5, COL, line); 
tmp = rd.rtc(&pcmos->bmemh); 
ui = (unsigned int)tmp << 8; 
tmp = rd_rtc(&pcmoB->bmeml); 
ui 1= (unsigned int)tmp; 
sprintf (line, "Base memory = # / 0 dK bytes 
disp_str(ROW + 5, COL, line); 
tmp = rd_rtc(&pcmos->lememh); 
ui = (unsigned int)tmp << 8; 
tmp = rd_rtc(&pcmos->lememl); 
ui |= (unsigned int)tmp; 
sprintf(line, "Expansion memory * %dK 
disp_str(ROW + 6, COL, line); 
tmp = rd_rtc(&pcmos->hememh); 
ui = (unsigned int)tmp << 8; 
tmp = rd_rtc(&pcmos->hememl); 
ui |= (unsigned int)tmp; 
sprintf(line, "Expansion memory = %dK 
disp^str(ROW + 7, COL, line); 


/* get drive a type */ 
/* display drive a type */ 
/* get drive b type */ 
/* display drive b type */ 
/* read hard disk types */ 
/* get drive c type */ 
/* display drive c type */ 
/* get drive d type */ 
/* display drive d type */ 
/* base memory high byte */ 
/* shift and assign */ 
/* base memory low byte */ 

/* add low byte */ 

", ui); 

/* display base memory */ 
/* expanded memory high byte */ 
/* shift and assign */ 
/* expanded memory low byte */ 

/* add low byte */ 

bytes", ui); 

/* display expanded memory */ 
/* expanded memory high byte */ 
/* shift and assign */ 
/* expanded memory low byte */ 

/* add low byte */ 

bytes", ui); 

/* display expanded memory */ 
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Initializing the Real-Time Clock 

To start up real-time clock interrupt processing, the rtcjinit function: 

• Disables real-time clock interrupts and update cycles 

• Initializes the processor interrupt vector, the real-time clock control, and 
alarm registers; and unmasks the interrupt controller input 

• Enables the real-time clock interrupts and update cycles 


/* rtc_init() - initialize alarms and vectors */ 


rtc_init() 
CMOS *pcmo8; 


/* ptr to RTC/CMOS structure */ 


pcmos =0; /* structure offset is zero */ 
wr_rtc(&pcmos->regb, SET_UPD I CLK24); /* prepare to init */ 
imask(l, 0, 0); /* disable PIC interrupt */ 
iv_init(0x70); /* initialize RTC interrupt vector */ 


wr_rtc(&pcmos->rega, DIVIDE.SEL | RATE_SEL); 

wr_rtc(&pcmos->alr_hr, 0x00); 

wr_rtc (&pcmos-‘>alr.min, 0x00); 

wr_rtc(&pcmos->alr_sec, 0x00); 

wr_rtc(&pcmos->regb, AIE | UIE | PIE | CLK24 

imask(l, 0, 1); 


/* set pi rate */ 
/* write hours alarm */ 
/* write minutes alarm */ 
/* write seconds alarm */ 
); /* enable clock */ 

/* enable PIC interrupt */ 
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Restoring the Interrupt Vectors 

To shut down real-time clock interrupt processing, the rtc_rest function: 

• Disables the real-time clock interrupts 

• Masks the interrupt controller input 

• Restores the interrupt vector to its previous condition 

NOTE 

Update cycles remain enabled. If update cycles are disabled, the 
clock stops. 

/* rtc_rest() - disable interrupts and restore vectors */ 

/♦sk*********************************************************************/ 

rtc_rest() 


CMOS *pcmo8; 

/* ptr to RTC/CMOS structure 

*/ 

pcmos = 0; 

/* structure offset is zero 

*/ 

wr_rtc(&pcmos->regb, CLK24); 

/* disable clock interrupts 

*/ 

imask(l, 0, 0); 

/* disable PIC interrupt 

*/ 

iv_rest(0x70); 

/* restore interrupt vector 

*/ 


> 
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Real-Time Clock Example 

The function rtc displays the menu, accepts input, and executes the examples. 


/* rtc() - execute RTC examples */ 

rtcO 

{ 

static MESSAGE mrtc[] = /* rtc menu */ 

{ 


{ 

3, 

24, 

"Real 

-time Clock and CMOS Example" 

>. 

{. 

5. 

24, 

"FI. 

Display CMOS hardware setup" 

>. 

i 

6 . 

24. 

"F2. 

Display CMOS checksum" >, 


i 

7. 

24, 

"F3. 

Display calculated CMOS checksum" 

{ 

8 . 

24, 

"F4. 

Set CMOS checksum" >, 


< 

9, 

24, 

"F5. 

Set date" >, 


i 

10, 

24, 

"F6. 

Set time" >, 



11. 

24. 

"F7. 

Set day-of-week" >, 



12, 

24, 

"F10. 

Return to Main menu" >, 



{ 0 , 0 , 0 }, 

>; 

unsigned char tmp; 
unsigned char sum; 
char line[512]; 
int i; 
int r; 

DATIM dt; 

CMOS *pcmos; 


/* to hold CMOS byte read */ 
/* to hold calculated checksum */ 
/* to hold input line */ 
/* to hold menu selection */ 
/* temp value */ 
/* place to store date k time */ 
/* ptr to RTC/CMOS structure */ 


#define ROW 16 
#define COL 17 

pcmos = 0; 
line[0] = 0; 
while(1) 

{ 

disp_menu(mrtc); 
switch(line[0]) 

i 

case FI: 
sh_hdw(); 
break; 


/* structure offset is zero */ 
/* null terminated */ 
/* forever (see F10) */ 

/* display the rtc menu */ 
/* determine menu selection */ 

/* show CMOS hardware */ 
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/* get current checksum */ 


case F2: 

sprintf(line, "CMOS checksum * %02x”, 
rd_rtc(&pcmos->cksuml)) ; 
disp.str(ROW, COL, line); 
break; 

case F3: /* calculate checksum */ 

sprintf(line, "Calculated checksum = %02x", rtc_cksum()); 
disp.str(ROW, COL, line); 
break; 

case F4: 

sum = rtc_cksum(); /* write calculated checksum */ 

wr_rtc(&pcmos->cksuml, sum); 

sprintf(line, "Checksum byte set to %02xH”, sum); 

disp^str(ROW, COL, line); 

break; 

case F5: /* set new date */ 

while(l) 

disp_str(ROW , COL."Enter date as MM/DD/YYYY"); 
disp_str(ROW + 1, COL, "Where MM represents the month (1 - 12)”); 
disp_str(ROW + 2, COL, "Where DD represents the day (1 - 31)”); 
disp_str(ROW + 3, COL, "Where YYYY represents the year (OOOO - 
9999)”); 

disp_str(ROW + 4, COL, "Date: "); 
get_keys(ROW + 4, COL + 6, line); 
r = sscanf(line, " # /,2d/%2d/ # /,4d” , &dt.month, 

&dt.dom, &dt.year); 
if(r != 3) continue; 
else break; 

> /* note: no limit check */ 

wr_rtc(&pcmos->month, bed(dt.month)); /* write month */ 

wr_rtc(&pcmos->dom, bcd(dt.dom)); /* write day-of-month */ 

wr_rtc(&pcmos->year, bcd(dt.year % 100)); /* write year */ 

wr_rtc(&pcmos->century, bcd(dt.year / 100)); /* write century */ 

rd_rtc(&pcmos->regd); /* make date valid, set the VRT bit */ 

8hw_date(); 
disp_menu(mrtc); 
break; 

case F6: /* set new time */ 

while(l) 

disp_str(ROW , COL, "Enter time as HH:MM:SS"); 
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disp_str(ROW + 1, COL, "Where HH represents the hour (0 - 23)”); 

disp_str(ROW + 2, COL, "Where MM represents the minutes (0 - 59)”); 

disp_str(ROW + 3, COL, "Where SS represents the seconds (0 - 59)”); 

disp_str(ROW + 4, COL, "Time: "); 

get_keys(ROW + 4, COL + 6, line); 

r = sscanf(line, " # / 0 2d:%2d:%2d”, &dt.hours, Adt. minutes, 
fcdt.seconds) ; 

if(r != 3) continue; 
else break; 

} /* note: no limit check */ 

wr_rtc(&pcmo8->hours, bed(dt.hours)); /* write hours */ 

wr_rtc(&pcmos->minutes, bed(dt.minutes)); /* write minutes */ 

wr_rtc(fcpcmos->seconds, bed(dt.seconds)); /* write seconds */ 

rd_rtc(&pcmos->regd); /* make time valid, set the VRT bit */ 

shw_time(); 
disp_menu(mrtc); 
break; 

case F7: 
while(l) 

disp_str(ROW, COL, "Enter day-of-week (1-7): "); 
get_keys(ROW, COL + 27, line); 
r = sscanfdine, "°/.d", ftdt.dow); 
if(r != 1) continue; 
else break; 

> /* note: no limit check */ 

wr_rtc(&pcmos->dow, bcd(dt.dow)); /* write day-of-week */ 

rd_rtc(&pcmos->regd); /* make DOW valid, set the VRT bit */ 

shw_date() ; 
disp_menu(mrtc); 
break; 

case F10: /* return to caller (main menu) */ 

return; 

> 

line[0] = get_fkey(); /* get a function key for menu selection */ 

> 

> 
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Chapter 6 
Three-Channel Counter 

and Speaker 


Overview 

The VAXmate processor board has an 8254 programmable interval timer that 
provides three independent 16-bit counters for counting or timing. All three 
counters have a 1.1931816 MHz clock input. The counters are programmable 
and are used by the ROM BIOS as follows: 

• Counter 0 is a general purpose timer to provide: 

- A time-of-day clock 

- A diskette drive motor timer 

- A screen blanking timer 

Its output goes to IRQO of the interrupt logic. 

CAUTION: Reprogramming this counter can destroy the timing. 

• Counter 1 provides the dynamic RAM refresh timing. The ROM BIOS 
programs it for a 15 n s cycle time. Its output is connected to the refresh 
counter. 

CAUTION: Reprogramming this counter can destroy the refresh cycle. 

• Counter 2 provides a frequency-modulated square wave output for the 
speaker interface. 


Additional Source of Information 

The following Intel Corporation document provides additional information on 
the 8254 three-channel counter/timer. 

• Microsystems Components Handbook (Publication Number 230843) 
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Block Diagram 

Figure 6-1 shows the block diagram of an 8254. The data bus buffer interfaces 
the I/O data bus, and the read/write logic interfaces the address bus on the 
CPU module. 



Clk 0 
Gate 0 

Out 0 
(IRQO) 


Clk 1 
Gate 1 

Out 1 
(Refresh) 


Clk 2 
Gate 2 

Out 2 
(Speaker) 


Figure 6-1 Three-Channel Counter/Timer Block Diagram 


Counter Description 

The three 16-bit synchronous down counters are identical in operation, but fully 
independent. Each counter has two 8-bit input latches (count registers), two 8- 
bit output latches, and a counting element. The counter control logic enables 
only one latch at a time. Therefore, writing a 16-bit count requires two 8-bit 
writes to the same register and reading a 16-bit count requires two 8-bit reads 
from the same register. 

The control word register provides for 8-bit and 16-bit counts. The 8-bit count 
can be written to either the least significant byte (LSB) or the most significant 
byte (MSB). Loading one 8-bit count register of a 16-bit pair clears the other 
count register. That is, writing an 8-bit count to the LSB clears the MSB and 
writing an 8-bit count to the MSB clears the LSB. 
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The signals CLK, GATE, and OUT are all connected to control logic on the 
CPU module. A 14.31818 MHz signal divided by 12 provides a 1.1931816 MHz 
clock to all three counters. 

A high level (1) at the GATE input enables counting and a low level (0) at the 
GATE input disables counting. 

Table 6-1 shows the CLK input frequency, the GATE source, and the destina¬ 
tion of the OUT signal. 


Table 6-1 Counter Signals 


Counter 

CLK Frequency 

GATE Source 

OUT Destination 

0 

1.1931816 MHz 

Tied high 

IRQO 

1 

1.1931816 MHz 

Tied high 

Refresh timer 

2 

1.1931816 MHz 

System CSR (bit 0) 

Speaker driver 


Mode Definitions 

The three-channel counter/timer has six modes of operation: 

Mode 0 Interrupt on Terminal Count 

Mode 1 Hardware Retriggerable One-Shot (not used) 

Mode 2 Rate Generator 

Mode 3 Square Wave Mode 

Mode 4 Software Triggered Strobe 

Mode 5 Hardware Triggered Strobe (retriggerable) 

Table 6-2 lists the default mode and function of each counter in the VAXmate 
workstation (as established by the ROM BIOS). 


Table 6-2 Modes Used by the Three Counters 


Counter 

Function 

Mode 

Description 

Output 

0 

Time-of-day clock 

5 

Hardware trig¬ 
gered strobe 

IRQO 

1 

Refresh timing 

2 

Rate generator 

Refresh counter 

2 

Speaker waveform 

3 

Square wave 

Speaker driver 
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Mode 0 (Interrupt on Terminal Count) 

Mode 0 is used for one-shot event counting. 

Initializing Mode 0 

Programming the control word for mode 0 causes OUT to go low. The GATE 
input has no effect on the OUT signal. 

If a new count is written during counting, the new count is loaded on the next 
CLK pulse and counting continues from the new count. 

Mode 0 Cycle 

Writing a new count starts the cycle. Where n equals the count, the mode 0 
cycle is n + 1 CLK pulses long. During the start of the cycle, the OUT signal 
is low for n CLK pulses (while the counter decrements from n to 0.) On the 
next CLK pulse, the OUT signal makes a transition from low-to-high. The OUT 
signal remains high until the control word is written or until a new count is 
written. 


Mode 1 (Hardware Retriggerable One-Shot) 

Mode 1 is used for one-shot event counting. Because the GATE input is the 
trigger, mode 1 is viable only on counter 2 (the GATE input of counters 0 and 
1 are tied high.) Mode 1 could be used for sound generation, but it is not nor¬ 
mally used on the VAXmate workstation. 

Initializing Mode 1 

Programming the control word for mode I and writing a new count causes 
OUT to go high and arms the trigger. The GATE input has no effect on the 
OUT signal. 

Writing a new count during counting has no effect on the current count. 
However, if the GATE input is triggered, the cycle restarts with the new count. 

Mode 1 Cycle 

With the trigger armed, a low-to-high transition at the GATE input triggers 
the cycle. On the next CLK pulse, the count is loaded and the OUT signal 
makes a high-to-low transition. Where n equals the count, the OUT signal re¬ 
mains low for n CLK pulses. That is, when the count decrements to 0, the 
OUT signal goes high. 

After the trigger is armed for the first time, the trigger remains armed until 
the control word is reprogrammed. Thus, after a count has decremented to 0, 
triggering the GATE input restarts the cycle. The count is reloaded 
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automatically. 

Triggering the GATE input before a count decrements to 0 restarts the cycle 
on the next CLK pulse. The count is reloaded automatically. Because the count 
did not expire, the OUT signal remains low. 


Mode 2 (Rate Generator) 

Where n equals the initial count, mode 2 functions like a divide by n counter. 

It generates pulses at a rate equal to the input frequency divided by the initial 
count (;i(. Mode 2 is periodic, repeating the cycle every n CLK pulses. 

The ROM BIOS uses counter 1 in mode 2 to provide the refresh timing signal. 
Initializing Mode 2 

Programming the control word for mode 2 causes OUT to go high. Providing 
that the GATE input is high, the cycle starts 1 CLK pulse after the initial 
count is written. 

If the GATE input goes low, the OUT signal goes high immediately. On the 
CLK pulse following a low-to-high transition at the GATE input, the counter 
reloads the initial count. Thus, the GATE input can synchronize the count to 
an external event. 

Writing a new count during counting has no effect on the count for the current 
cycle. When the cycle repeats, the count is reloaded with the new count. 
However, if the GATE input is triggered, the new count is loaded on the next 
CLK pulse and cycle restarts. 

Mode 2 Cycle 

Where n is the initial count, the mode 2 cycle is n CLK pulses long. During 
the start of the cycle, the OUT signal is high. The OUT signal remains high 
until the count decrements to 1. When the count decrements to 1, the OUT 
signal makes a high-to-low transition and the counter reloads the initial count. 
The OUT signal is low only for that CLK pulse. On the next CLK pulse, the 
OUT signal goes high and the cycle repeats. 

NOTE 

In mode 2, a count of 1 is invalid. 


Mode 3 (Square Wave Mode) 

Mode 3 generates a square wave at the OUT signal. Where n is the count, the 
OUT signal has a frequency equal to CLK / n. When n is an even number, the 
OUT signal is high for n I 2 CLK pulses and then low for n I 2 CLK pulses. 
When n is an odd number, the OUT signal is high for (ra + 1) / 2 CLK pulses 
and then low for (n - 1) / 2 CLK pulses. 
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Initializing Mode 3 

Programming the control word for mode 3 causes OUT to go high. Providing 
that the GATE input is high, the cycle starts 1 clock pulse after the initial 
count is written. 

If the GATE input goes low, the OUT signal goes high immediately. On the 
CLK pulse following a low-to-high transition at the GATE input, the counter 
reloads the initial count. Thus, the GATE input can synchronize the count to 
an external event. 

Writing a new count during counting has no effect on the count for the current 
cycle. When the cycle repeats, the count is reloaded with the new count. 
However, if the GATE input is triggered, the new count is loaded on the next 
CLK pulse and cycle restarts. 

Mode 3 Cycle 

In the first CLK pulse, the initial count is loaded. If the count is odd, then 
count - 1 is loaded. The cycle starts with the next CLK pulse. 

With each succeeding CLK pulse, the count is decremented by two. When the 
count decrements to 0, the initial count is tested for an odd or even value. If 
the initial count was even, the OUT signal makes an immediate transition from 
high-to-low. If the initial count was odd, the counter waits one more CLK pulse 
and then makes a high-to-low transition. The initial count is reloaded and dec¬ 
remented by two, which starts the second half of the cycle. With each succeed¬ 
ing CLK pulse, the count is decremented by two. When the count decrements 
to 0, the OUT signal makes an immediate transition from low-to-high; the in¬ 
itial count is reloaded and decremented by two, which starts a new cycle. 


Mode 4 (Software Triggered Strobe) 

In mode 4, the count cycle is triggered by writing a new count. Where n equals 
the initial count, the OUT signal is high for n + 1 CLK pulses, low for 1 CLK 
pulse, and then high until a new count is written. 

Initializing Mode 4 

Programming the control word for mode 4 causes OUT to go high. The GATE 
input has no effect on the OUT signal. 

If a new count is written during counting, the new count is loaded on the next 
CLK pulse and counting continues from the new count. 

For a 2-byte count, writing the first byte has no effect on counting. Writing the 
second byte allows the count to be loaded on the next CLK pulse. 

Writing a new count while the original count is counting allows the new count 
to be loaded on the next CLK pulse. 
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Mode 4 Cycle 

The mode 4 cycle is triggered by writing a new count. The new count is loaded 
on the next CLK pulse, but not decremented. With each successive CLK pulse, 
the count is decremented. When the count decrements to 0, the OUT signal 
goes low. It remains low for 1 CLK pulse. When the count decrements to 
FFFFH, the OUT signal goes high. Until a new count is written, the OUT 
signal remains high, which restarts the cycle. 

Mode 5 (Hardware Triggered Strobe) 

Because the GATE input is the trigger, mode 5 is viable only on counter 2 (the 
GATE input of counters 0 and 1 are tied high.) Where n equals the initial 
count, the OUT signal is high for n + 1 CLK pulses, low for 1 CLK pulse, 
and then high until the GATE input triggers another cycle. 

Initializing Mode 5 

Programming the control word for mode 1 and writing a new count causes 
OUT to go high and arms the trigger. The GATE input has no effect on the 
OUT signal. 

Writing a new count during counting has no effect on the current count. 
However, if the GATE input is triggered, the cycle restarts with the new count. 

Mode 5 Cycle 

With the trigger armed, a low-to-high transition at the GATE input triggers 
the cycle. The new count is loaded on the next CLK pulse, but not decre¬ 
mented. With each successive CLK pulse, the count is decremented. When the 
count decrements to 0, the OUT signal goes low. It remains low for 1 CLK 
pulse. When the count decrements to FFFFH, the OUT signal goes high. 

After the trigger is armed for the first time, the trigger remains armed until 
the control word is reprogrammed. Thus, after a count has decremented to 0, 
triggering the GATE input restarts the cycle. 

Triggering the GATE input before a count decrements to 0 restarts the cycle 
on the next CLK pulse. The count is reloaded automatically. Because the count 
did not expire, the OUT signal remains high. 
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Registers 

This section discusses the 8254 registers. Because bit 0 controls the GATE 
input of counter 2 and bit 1 controls the output to the speaker, the system 
register is also discussed here. Table 6-3 shows the addresses of the 8254 regis¬ 
ters and the system register. 

Table 6-3 8254 and System Register Addresses 


Register 

R/W 

Address 

8254 - Counter 0 

R/W 

0040H 

8254 - Counter 1 

R/W 

0041H 

8254 - Counter 2 

R/W 

0042H 

8254 - Command Word 

W 

0043H 

System 

R/W 

0061H 
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System Register (0061H) 


7 

6 

5 

4 

3 

2 

1 

0 

RAM 

PARITY 

CHECK 

I/O 

CHECK 

COUNTER 
2 OUT 
SIGNAL 

REFRESH 

REQUEST 

ENABLE 

I/O 

CHECK 

ENABLE 

RAM 

PARITY 

SPEAKER 

DATA 

COUNTER 

2 

GATE 

INPUT 


Bit R/W Description 


7 


6 


5 


4 


3 


2 


R RAM PARITY CHECK 

0 = Processor board RAM parity good 
1 = Processor board RAM parity error 

W Always 0 

R I/O CHECK 

0 = No bus I/O error or option RAM parity error 
1 = Bus I/O or option RAM parity error exists 

W Always 0 

R COUNTER 2 OUT SIGNAL 

0 = Counter 2 OUT signal is low 
1 = Counter 2 OUT signal is high 

W Always 0 

R REFRESH REQUEST 

0 = Refresh request not active 
1 = Refresh request active 

The diagnostic software uses this bit to check the operation of the 
DRAM refresh circuitry. 

W Always 0 

R/W ENABLE I/O CHECK 

0 = Enables checking of the bus I/O check line and option RAM 
parity (enabled by ROM BIOS) 

1 = Disable bus I/O error checking 

R/W ENABLE RAM PARITY CHECK 

0 = Enable processor board RAM parity checking (enabled by 
ROM BIOS) 

1 = Disable processor board RAM parity checking 
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Bit R/W Description (System Register • cont.) 


0 


6 - m 


R/W SPEAKER DATA 

0 = No sound output from speaker 

1 = Sound output from speaker (Counter 2 OUT signal must be 
high or generating a frequency) 

The output of this bit is ANDe d with the Counter 2 OUT 
SIGNAL. Assuming that the counter 2 OUT signal is high, tog¬ 
gling this bit generates a pulse train to the speaker driver. 
Otherwise, to enable sound output to the speaker, this bit must 
equal 1. 

R/W COUNTER 2 GATE INPUT 

0 = Counter 2 GATE input is low 
1 = Counter 2 GATE input is high 
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Control Word Register (0043H) 

7 6 5 4 3 2 1 0 


1 

1 

-r - - 1 - 

BINARY 

SELECT 

READ/ 

MODE 

CODED 

COUNTER 

_1_ 

WRITE 

_1_ 

SELECT 

_1_1_ 

DECIMAL 


Bit R/W Description 


7-6 

W 

SELECT COUNTER 



00 = 

Select counter 0 



01 = 

Select counter 1 



10 = 

Select counter 2 



11 = 

Read-back command 

5-4 

W 

READ/WRITE 



00 = 

Counter-latch command 



01 = 

Read/Write LSB 



10 = 

Read/Write MSB 



11 = 

Read/Write LSB first, then MSB * 

3-1 

W 

MODE SELECT 



000 = 

= Mode 0 



001 = 

= Mode 1 



X10 = 

= Mode 2 



Xll = 

= Mode 3 



100 = 

= Mode 4 



101 = 

= Mode 5 

0 

W 

BINARY CODED DECIMAL 



0 = 

Binary counter 16 bits 



1 = 

Binary-coded-decimal (BCD) counter (4 decades) 


* The counter does not start counting until the second byte of the 2-byte 
pair is written to the counter latch. 
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Counter-Latch Command (Control Word Register) 


7 6 

5 

4 

3 

2 

1 

0 

i 

SELECT 

COUNTER 

0 

0 

0 

0 

0 

0 


Bit R/W Description 


7-6 W 

SELECT COUNTER 


00 = 

Select Counter 0 


01 = 

Select Counter 1 


10 = 

Select Counter 2 


11 = 

Undefined 

5-0 W 

Always 0 for counter-latch command 


Counter-latch commands do not affect the programmed mode of the counter. 
The counter-latch command latches the contents of the counters without affect¬ 
ing the count in progress. When the 8254 receives a counter-latch command, it 
latches the selected counter into the counters output latch. The latched count 
is held until read by the CPU (or until the counter is reprogrammed). After the 
latched count is read, the output latch follows the count in the counter. 

When a counter-latch command is issued for more than one counter, each 
counter output latch holds the count until read. When any given counter is 
latched two or more times without an intervening read, only the first latch 
command is effective. When read, the count is the count latched by the first 
counter-latch command. 

The latched count must be read according to the programmed format (LSB, 
MSB, or LSB and MSB). 
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Read-Back Command (Control Word Register) 


7 

6 

5 

4 

3 

2 

1 

0 

1 

1 

LATCH 

COUNT 

LATCH 

STATUS 

COUNTER 

2 

SELECT 

COUNTER 

1 

SELECT 

COUNTER 

0 

SELECT 

0 


Bit 

R/W 

Description 

7-6 

W 

Always 11 

5-4 

W 

LATCH COUNT and LATCH STATUS 

00 = Latch status and count of selected counter(s) 

01 = Latch count of selected counter(s) 

10 = Latch status of selected counter(s) 

11 = Undefined 

3 

W 

COUNTER 2 SELECT 

0 = Counter 2 not selected 

1 = Counter 2 selected 

2 

W 

COUNTER 1 SELECT 

0 = Counter 1 not selected 

1 = Counter 1 selected 

1 

W 

COUNTER 0 SELECT 

0 = Counter 0 not selected 

1 = Counter 0 selected 

0 

W 

Always 0 


The read-back command is written to the control word register. For the se¬ 
lected counters, the read-back command latches a status byte and/or the cur¬ 
rent count. 

The status byte format is described under Status Response. The status byte is 
read from the indicated counter register as a single 8-bit byte. When the read- 
back command latches both status and count, the status byte is read first and 
then the count. Thereafter, any read returns an unlatched count. 

The latched count follows the format described under Counter-Latch Command, 

If multiple read-back commands are issued without intervening reads, all but 
the first are ignored. The status read is the status at the time of the first 
read-back command. 
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Status Response (Read-back Command) 


76543210 


OUT 

NULL 

-1- 

READ/ 

-1-1- 

SELECTED 

BINARY 

CODED 

PIN 

COUNT 

WRITE 

__1_ 

MODE 

_1_1_ 

DECIMAL 


Bit R/W Description 

7 R OUT PIN 

1 = OUT pin is high (1) 

0 = OUT pin is low (0) 

6 R NULL COUNT 

0 = New count is loaded and is available for reading. 

I = Null count 

A write to the control word register has occurred, which sets the 
null count bit of specified counter. If the counter is programmed 
for 2-byte counts, when the second byte is written, the null count 
goes to 1. 

5-4 R READ/WRITE 

00 = Counter-latch command 
01 = Read/Write LSB 
10 = Read/Write MSB 

II = Read/Write LSB first, then MSB. 

3-1 R SELECTED MODE 

000 = Mode 0 
001 = Mode 1 
X10 = Mode 2 
XI1 = Mode 3 

100 = Mode 4 

101 = Mode 5 

0 R BINARY CODED DECIMAL 

0 = Binary counter 16 bits 

1 = Binary-coded-decimal (BCD) counter (4 decades) 
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Programming Example 

The three channel counter/timer and speaker programming example 
demonstrates: 

• Writing the counter/timer registers 

• Enabling and disabling the output to the speaker 

• Setting the output frequency to the speaker 

The example provides routines as described in the following list: 

wr_cntl6 Writes a 16-bit value to the indicated counter 
beep Enables the bell (beep) at the speaker 

unbeep Disables the bell (beep) at the speaker 

tim_spk Initializes the counter, displays the menu, and executes the ex¬ 

ample program 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 

Constant Values 

The included file kyb.h defines constant values for function keys. For informa¬ 
tion about keyboard programming, see Chapter 8. For a listing of the file 
kyb.h, see Appendix A. 

The included file example.h defines the structure type MESSAGE that is used 
to display the menu. For a listing of the file example.h, see Appendix A. 

The constant value systat defines the offset of the system status register in 
I/O space. 

The constant values cwrdreg through count2 define the offset of the 8254 
counter/timer registers in I/O space. 

The constant values selcntO through rbcnt2 define the bit values of various 
8254 counter/timer commands. 

The constant value inpfreq defines the input frequency to all three counter/ 
timers. 
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#include "kyb.h" 
#include "example.h" 


/* reference function key constants */ 
/* reference menu structure */ 


/* define constants used to program 8254 timer */ 

/***********************************************************************/ 


#define 

SYSTAT 

0x61 

/* system status register in I/O space 

*/ 

#define 

CWRDREG 

0x43 

/* control word register in I/O space 

*/ 

#define 

COUNTO 

0x40 

/* 

counter 

0 register in I/O space 

*/ 

#define 

C0UNT1 

0x41 

/* 

counter 

1 register in I/O space 

*/ 

#define 

C0UNT2 

0x42 

/* 

counter 

2 register in I/O space 

*/ 

#define 

SELCNTO 

0x00 



/* select counter 0 

*/ 

#define 

SELCNT1 

0x40 



/* select counter 1 

*/ 

#define 

SELCNT2 

0x80 



/* select counter 2 

*/ 

#define 

SELRDBK 

OxCO 



/* select read back 

*/ 

#define 

LATCOM 

0x00 



/* select latch command 

*/ 

#define 

RWLSB 

0x10 



/* read/write LSB 

*/ 

#define 

RWMSB 

0x20 



/* read/write MSB 

*/ 

#define 

RWLSMS 

0x30 


/* 

read/write LSB then MSB 

*/ 

#define 

TMODEO 

0x00 



/* select timer mode 0 

*/ 

#define 

TM0DE1 

0x02 



/* select timer mode 1 

*/ 

#define 

TM0DE2 

0x04 



/* select timer mode 2 

*/ 

#define 

TM0DE3 

0x06 



/* select timer mode 3 

*/ 

#define 

TM0DE4 

0x08 



/* select timer mode 4 

*/ 

#define 

TM0DE5 

0x09 



/* select timer mode 5 

*/ 

#define 

BINDAT 

0x00 



/* binary count data 

*/ 

#define 

BCDDAT 

0x01 

/* 

binary 

coded decimal count data 

*/ 

#define 

LATCNT 

0x20 


/* read back cmd latch count 

*/ 

#define 

LATSTA 

0x10 


/* read back cmd latch status 

*/ 

#define 

RBCNTO 

0x02 



/* read back counter 0 

*/ 

#define 

RBCNT1 

0x04 



/* read back counter 1 

*/ 

#define 

RBCNT2 

0x08 



/* read back counter 2 

*/ 

#define 

INPFREQ 

1193181L 

/* 14.31818 

Mhz / 12 - 1.1931816 Mhz 

*/ 
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Writing a Counter 

The function wr_cntl6 writes a 16-bit value to the indicated counter. A 16-bit 
value is written 8-bits at a time (low byte first) to the same port. 

Making a Bell Sound 

The function beep enables the speaker output at 1000 Hz. It provides the bell 
(beep sound) for the ASCII character BEL (07H). This function can be called at 
any time. The speaker output is automatically disabled by the function unbeep. 

The function unbeep monitors the variable beep_flag. If required, it disables the 
speaker. This function is called from within the real time clock interrupt han¬ 
dler. It tracks the number of 125 ms periods that the speaker has been on for 
a bell (beep sound). After 500 ms total, the speaker output is disabled. If the 
real time clock interrupts are not enabled, the speaker output will not be 
disabled automatically. 
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/***********************************************************************/ 
/* wr_cntl6() - write 16-bit value to counter */ 

/***********************************************************************/ 


wr_cntl6(counter, value) 


imsigned char counter; 
unsigned int value; 


/* which counter to set */ 
/* 16-bit value */ 


{ 

unsigned int intr_flag; /* to hold current IF state */ 


intr_flag = int_off(); 
outp(counter | COUNTO, value k Oxff); 
outp(counter | COUNTO, value >> 8); 
int_on(intr_flag); 


/* disable interrupts */ 
/* write counter low byte */ 
/* write counter high byte */ 
/* enable interrupts */ 


> 

j ********************************** :1c**************** sic******* ft*********** f 

/* beep() - start up beep sound at speaker */ 

J *********************************************************************** J 
int beep_flag; /* true while beeping */ 


beepO 

wr_cntl6(2, (int)(INPFREQ / 1000L)); /* set desired frequency */ 

outp(SYSTAT, 0x03); /* turn speaker on */ 

beep_flag =1; /* set flag, speaker is on */ 

> 


J *********************************************************************** j 
/* unbeepO - time to stop beep sound at speaker ? */ 
J *********************************************************************** J 


unbeepO 

{ 

if(beep_flag) 

if(++beep_flag > 3) 

outp(SYSTAT, 0x00); 
beep_flag = 0; 

> 


/* are we making a beep sound */ 
/* has it been on long enough */ 

/* turn it off */ 
/* reset flag */ 
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Counter and Speaker Example 

The function timjspk initializes the counter, displays the menu, and executes 
the example. 


/* tim_8pk() - execute timer and speaker examples */ 

/**************************♦*******************************♦************/ 


tim_spk() 

static MESSAGE mtim_spk[] = /* menu for timer/speaker example */ 


{ 

3, 

24, 

”8254 

Timer and Speaker Example” }, 


B, 

24. 

"FI. 

Set frequency to speaker” }, 


6. 

24. 

"F2. 

Speaker on” }, 

•c 

7, 

24. 

"F3. 

Speaker off” >, 

< 

8, 

24. 

"F4. 

DO-RE-MI” }, 

-c 

9, 

24. 

"F10. 

Return to Main menu” >, 


0 , 

0 . 

0 >, 



>; 

static int tone[8] = /* frequencies for notes to do-re-mi */ 

{ 2281, 2032, 1810, 1709, 1524, 1366, 1209, 1140 >; 


char line[512]; 
unsigned int freq; 
unsigned int tval; 
unsigned int i; 


/* to hold input line */ 
/* to remember frequency */ 
/* general temporary */ 
/* iteration control */ 


extern unsigned int metronome; /* defined in clock example */ 

/* maintains beat of do-re-mi */ 

#define ROW 16 
#define COL 17 

line[0] = 0; 

freq = 1000; /* default frequency */ 

/* initialize counter mode */ 
outp(CWRDREG, SELCNT2 | RWLSMS | TM0DE3 | BINDAT); 
while(l) 

{ 

di8p_menu(mtim_8pk); 
switch(line[0]) 

case FI: /* set output frequency */ 

disp_str(ROW, COL, f, Enter new frequency (19Hz - 20000Hz) : H ) ; 
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get_keys(ROW, COL + 37, line); 
sscanf(line, "%d M , Afreq); 
if(freq < 18) freq = 19; 
else if(freq > 20000) freq = 20000; 
tval = (int)(INPFREQ / (long)freq); 
wr_cntl6(2, tval); 
disp_menu(mtim_spk); 
break; 


case F2: /* turn speaker on */ 

outp(SYSTAT, 0x03); 
break; 


case F3: /* turn speaker off */ 

outp(SYSTAT, 0x00); 
break; 


case F4: 
i * 0; 

metronome = Oxffff; 
while(metronome) ; 
wr_cntl6(2, tone[i++]); 
outp(SYSTAT, 0x03); 
whiled < 9) 

if(metronome > 3) 

{ 

wr_cntl6(2, tone[i++]); 
metronome = 0; 

> 

chk_dt(); / 

> 

outp(SYSTAT, 0x00); 
tval = (int)(INPFREQ / (long)freq); 
wr_cntl6(2, tval); 
break; 

case F10: 
return; 

> 

line[0] = get_fkey(); 


/* play do-re-mi */ 

/* iteration count = 0 */ 
/* prepare counter to overflow */ 
/* wait until it overflows */ 
/* start first note */ 
/* enable speaker */ 
/* do all notes */ 

/* hold note for 500 ms */ 

/* next note */ 
/* reset counter */ 

redisplay time for menu ? */ 

/* turn speaker off */ 
/* reset frequency */ 


/* return to caller */ 


/* get function key */ 
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Chapter 7 
Video Controller 


Introduction 

The VAXmate video controller is on the I/O board and drives a monochrome 
monitor. The video controller can process 16 colors or shades of gray. In this 
chapter, the term color also means shades of gray or intensity levels. 

Industry-Standard Text and Graphics Features 

The VAXmate video controller has the following industry-standard text and 
graphics features: 

• 80 x 25 and 40 x 25 text display 

• 8x8 graphics character cell 

• character attributes: 

16 foreground colors 

16 background colors or 8 background colors plus blink 

• bit map graphics with industry-standard color palettes 

320 x 200 4 colors 
640 x 200 2 colors 
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Enhancements to Industry-Standard Features 

The video controller has the following enhancements to industry-standard 
features: 

• The screen resolution is 640 horizontal pixels by 400 scan lines. 
Industry-standard graphics (200 scan lines) is accomplished by 
displaying each scan line twice. 

• The character pattern is 8 horizontal pixels by 16 scan lines, result¬ 
ing in higher quality characters in text modes. 

• The 256-character font RAM provides flexibility in terminal emula¬ 
tion and multilingual applications. 

• The dual-port video memory eliminates annoying screen flicker (dis¬ 
abling the screen before accessing video memory is unnecessary). 

• The 16-bit data path to video memory, coupled with the dual-port 
access results in faster screen updates. 

Industry-Standard Features Not Available 

The video controller does not support these features: 

• 160 x 100 16-color graphics mode 

• 15.75 KHz monitor support 

• Border color support 

• Light pen support 

Extra Features 

The video controller has the following additional graphic features: 

• 640 x 400 2-color graphics 

• 640 x 400 4-color graphics 

• 640 x 200 4-color graphics 

• 800 x 252 4-color graphics 

• 320 x 200 16-color graphics 

• 256-character soft font 
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Block Diagram 

The video controller consists of a display processor and video memory that 
reside on the I/O board. As shown in Figure 7-1, the display processor includes 
a translation ROM, a 6845 CRT controller, text video logic, graphics video 
logic, a video look-up table, and status and control registers. 



Figure 7-1 Block Diagram of the VAXmate Video Controller 

The translation ROM translates industry-standard color graphic adapter data to 
data that is correct for the DIGITAL video controller. 

The 6845 CRT Controller (CRTC) internal registers control horizontal and ver¬ 
tical positioning, synchronization, video and cursor starting addresses, and 
width of video display. 

Two status registers monitor vertical synchronization, video blanking time, and 
various modes in the control registers. 

The two control registers enable the various text and graphics modes, enable 
and disable the display, select the font RAM, select the video look-up table 
(VLT), and provide screen saver support. 
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64K bytes of dual-ported memory, which maps into the address space of the 
VAXmate CPU. 

The display processor converts memory data into various raster formats. The 
display processor generates IRGB outputs that drive the monochrome monitor. 
The VAXmate monitor displays the color information as different levels of in¬ 
tensity (shades of gray). 

Additional Sources of Information 

The following documents provide additional information on the video controller: 
Device Company Document 

6845-1 Motorola 8-Bit Microprocessor & Peripheral Data 

HD46505S Hitachi 8/16-Bit Multi-Chip Microcomputer Data Book 
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Video Modes 

The video controller has several modes, some of which have a mode number 
assigned indicating that the ROM BIOS supports these modes. For modes not 
supported by the ROM BIOS, the hardware must be programmed directly. 

Table 7-1 shows the available video modes. 

For industry-standard color graphic adapters, the difference between a color 
and a monochrome mode is the presence (color) or absence (monochrome) of the 
color burst signal in the composite video output. Because the VAXmate video 
controller does not provide a composite video output, there is no difference be¬ 
tween the color and the monochrome modes. 

On powerup or system reset, the video system is initialized to mode 03 H. 


Table 7-1 Available Video Modes 


Mode Size 


00H 

40 x 25 

01H 

40 x 25 

02h 

80 x 25 

03h 

80 x 25 

04H 

320 x 200 

05h 

320 x 200 

06h 

640 x 200 

- 

320 x 200 

dOh 

640 x 400 

dlh 

640 x 400 

d2h 

800 x 252 

- 

640 x 200 


Description 


text mode monochrome (industry-standard) 
text mode color (industry-standard) 
text mode monochrome (industry-standard) 
Text mode color (industry-standard) 

4-color graphics mode (industry-standard) 
monochrome graphics (industry-standard) 
monochrome graphics mode (industry-standard) 
16-color graphics mode (digital extended) * 
2-color graphics mode (digital extended) 

4-color graphics mode (digital extended) 

4-color graphics mode (digital extended) ** 
4-color graphics mode (DIGITAL extended) * 


* No ROM BIOS support 

** Limited ROM BIOS support 
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Text Modes 

The video controller has a 16 Kbyte text buffer in the address range B8000H- 
BBFFFH. Video modes 00H, 01H, 02H, and 03H use the text buffer. 

For modes 00H and 01H, the text buffer provides 8 display pages of 2048 
bytes each. For modes 02H and 03H, the text buffer provides 4 display pages 
of 4096 bytes each. 

Character Buffer Format 

A displayed character is represented by two consecutive bytes. The first byte, 
of the 2-byte pair, is the character code. The character code is stored at an 
even address. The second byte, of the 2-byte pair, is the attribute byte. The 
attribute byte is stored at the odd address following the character code. Figure 
7-2 shows the character code and attribute byte addressing. Table 7-2 defines 
the meaning of each bit within the attribute byte. 


B8000H B8001H B8002H B8003H . BBFFEH BBFFFH 

Even Odd Even Odd Even Odd 


Even Odd Even Odd Even Odd 


Char 

Attr 

Char 

Attr 


Char 

Attr 

Code 


Code 



Code 



Figure 7-2 Character Buffer Format 


Table 7-2 Attribute Byte Bit Definitions 


Bit 

Symbol 

Definition 

7 

lb 

Background intensity / Blink * 

6 

Rb 

Red contribution to background color 

5 

Gb 

Green contribution to background color 

4 

Bb 

Blue contribution to background color 

3 

If 

Foreground intensity 

2 

Rf 

Red contribution to foreground color 

1 

Gf 

Green contribution to foreground color 


Bf 

Blue contribution to foreground color 


* The selection of background intensity or blink is determined by bit 7 of 
control register A. Control register A is described later in this chapter. 
When blink is enabled, the blink frequency is 1.9 Hz. 
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Character Position to Memory Location Mapping 

Character positions on the screen are identified as row (vertical) and column 
(horizontal) locations. The first character is displayed in the upper-left corner of 
the screen, which is location 0,0. To translate between screen positions and the 
address within the text buffer, use the following formula: 

Character code address = start_address + (row * 2 * Y) + (column * 2) 

Attribute address = Character code address + 1 

Where: 


start_address = 
row = 


Display page start address (see Table 7-3) 
0 to 24 


column = 
Y = 


0 to 79 (80 X 25 modes) 
0 to 39 (40 X 25 modes) 

80 (80 X 25 modes) 

40 (40 X 25 modes) 


In text modes, the video processor supports multiple display pages. For direct 
programming, registers R12 and R13 (described later in this chapter) control 
the display-page start address. Each displayed character requires 2 bytes (char¬ 
acter code and attribute byte). Therefore, the 80 x 25 modes require 4000 
bytes (80 x 25 x 2) and the 40 x 25 modes require 2000 bytes 
(40 x 25 x 2). The ROM BIOS also supports multiple display pages and 
rounds the memory requirements to 4096 bytes and 2048 bytes respectively. 
Table 7-3 shows the display page addresses as defined by the ROM BIOS. 
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Table 7-3 Text Mode Display Pages (ROM BIOS) 


Address 

80 x 25 

Display Page 

40 x 25 

Display Page 

B8000H 

0 

0 

B8800H 


1 

B9000H 

1 

2 

B9800H 


3 

BA000H 

2 

4 

BA800H 


5 

BB000H 

3 

6 

BB800H 


7 


Programmable Cursor 

For text modes only, the video controller provides a programmable cursor blink 
rate and cursor block size. The cursor blink is determined by bits 6-5 of regis¬ 
ter RIO. The cursor blinks with alternate foreground and background color of 
the character at the cursor position. The cursor block size is controlled by bits 
4-0 of registers RIO and Rll. Registers RIO and Rll are discussed later in 
this chapter. 


7- 8 


Video Controller - Hardware Description 






Programmable Character Generator (Font RAM) 

The video controller has a 4 Kbyte programmable font RAM. The font RAM 
can store patterns for 256 characters. Normally, the font RAM is accessible 
only to the video controller. That is, the font RAM is not mapped into the 
normal CPU address space. Accessing the font RAM requires that the video 
mode be one of the text modes 00H, 01H, 02H, or 03H. Bit 4 of control regis¬ 
ter B (described later in this chapter) controls access to the font RAM. When 
bit 4 of control register B equals 1, access to the video text buffer is disabled 
and access to the font RAM is enabled. Only even text buffer addresses are 
connected to the font RAM. The text buffer to font RAM mapping appears as 
follows: 


Text Buffer Offset Font Ram Offset 


B8000H 

B8001H 

0000H (first byte of font RAM) 

B8002H 

B8003H 

0001H (second byte of font RAM) 

B8004H 

0002H (third byte of font RAM) 

B8005H 

B9FFDH 

• 

B9FFEH 

0FFFH (last byte of font RAM) 


NOTE 

The ROM BIOS does not support the use of the font RAM in 
any graphics video mode. 

A character pattern consists of 16 bytes of pixel information. Each byte repre¬ 
sents 8 consecutive pixels of a horizontal scan line for the character. The most 
significant bit (bit 7) corresponds to the left-most pixel (pixel 0). The least sig¬ 
nificant bit (bit 0) corresponds to pixel 7. Each byte of the character pattern is 
read or written to an even address. Thus, each character pattern requires 32 
bytes of address space and an entire 256-character font requires 8K bytes. To 
calculate the address of the first byte of a character pattern, use the following 
formula: 

Character pattern start address = B8000H + (character code * 32) 
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Graphics Mode 

Each pixel on the screen is mapped into a bit-field of the corresponding byte in 
the display buffer. The width of the bit-field can be of 1, 2 or 4 bits depending 
on whether a 2-color, 4-color, or 16-color format is chosen. 

Mapping the Display to Address 

The logical display consists of a rectangular array of 200, 252, or 400 scan 
lines of pixels. For 200 scan line mode, the hardware generates two physical 
scan lines for each logical scan line. Each scan line is represented by 
(M / 8) * n consecutive bytes, where: 

M = Number of pixels per scan line 
n = 1, for 1-bit per pixel (2-color display! 
n = 2, for 2-bits per pixel (4-color display! 
n = 4, for 4-bits per pixel (16-color display! 

The memory maps for various graphic formats are shown on the following 
pages. Each memory map shows two or more blocks of memory that refer to: 

(L MOD P) = R 


Where: 


L is the desired scan line 

P is the number of memory blocks for the current video mode 
R is the remainder of the division L I P 

The remainder, R, specifies the memory block for a particular scan line. 
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320 x 200 4-Color Mode 

ROM BIOS Video Modes: 04H and 05H ■ Industry-Standard 


In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-3 for the memory organization. See Figure 7-4 for the pixel to 
bit-field map. 

I- 80 BYTES PER SCAN LINE -1 


B8000H 


B804FH 


(L MOD 2) = 0 


B9F00H 


B9F3FH 



BA000H 


BA09FH 


(L MOD 2) = 1 


BBF00H 


BBF3FH 


L = SCAN LINE 0 TO 199 

Figure 7-3 Memory Organization for 320 x 200 4-Color Mode 



LEFT MOST PIXEL 


RIGHT MOST PIXEL 


Figure 7-4 Pixel to Bit-Field Map for 4-Color Mode 
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320 x 200 16-Color Mode 

No ROM BIOS Support ■ DIGITAL Extended, 

In 16-color mode, a single byte corresponds to 2 consecutive pixels on the 
screen with the most significant bit of the byte corresponding to the left of the 
screen. See Figure 7-5 for the memory organization. See Figure 7-6 for the 
pixel to bit-field map. 

|- 160 BITES PER SCAN LINE -1 

T 

D 
I 
G 
I 
T 
A 
L 


V 

I 

D 

E 

0 

i 


Figure 7-5 Memory Organization for 320 x 200 16-Color Mode 
76543210 


LEFT PIXEL RIGHT PIXEL 

Figure 7-6 Pixel to Bit-Field Map for 16-Color Mode 
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640 x 200 2-Color Mode 

ROM BIOS Video Mode: 06H - Industry-Standard 

In 2-color mode, a single byte corresponds to 8 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-7 for the memory organization. See Figure 7-8 for the pixel to 
bit-field map. 

I- 80 BYTES PER SCAN LINE -1 



L = SCAN LINE 0 TO 199 

Figure 7-7 Memory Organization for 640 x 200 2-Color Mode 
6 5 4 3 2 1 


CBO 

CBO 

CBO 

CBO 

CBO 

CBO 

CBO 

CBO 


LEFT 

HOST 

PIXEL 
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PIXEL 


Figure 7-8 Pixel to Bit-Field Map for 2-Color (Monochrome) Mode 


Video Controller - Hardware Description 7-13 
















640 x 200 4-Color Mode 

No ROM BIOS Support - DIGITAL Extended 

In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-9 for the memory organization. See Figure 7-10 for the pixel to 
bit-field map. 



L = SCAN LINE 0 TO 199 


Figure 7-9 Memory Organization for 640 x 200 4-Color Mode 


76543210 



LEFT HOST PIXEL RIGHT MOST PIXEL 


Figure 7-10 Pixel to Bit-Field Map for 4-Color Mode 
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640 x 400 2-Color Mode 

ROM BIOS Video Mode: DOH ■ DIGITAL Extended 

In 2-color mode, a single byte corresponds to 8 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-11 for the memory organization. See Figure 7-12 for the pixel to 
bit-field map. 



B8000H 

B9F00H 


BA000H 

BBFOOH 


BC000H 

I Ibdfooh 


80 BYTES PER SCAN LINE 


(L MOD 4) = 0 


(L MOD 4) = 1 


(L MOD 4) = 2 


B809FH 

B9F3PH 


BA09FH 

BBF3FH 


BC09FH 

BDF3FH 


BE000H 


BE09FH 


(L MOD 4) = 3 


BFFOOH 


BFF3FH 


L = SCAN LINE 0 TO 399 

Figure 7-11 Memory Organization for 640 x 400 2-Color Mode 
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Figure 7-12 Pixel to Bit-Field Map for 2-Color Mode 
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640 x 400 4-Color Mode 

ROM BIOS Video Mode: D1H - DIGITAL Extended 

In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-13 for the memory organization. See Figure 7-14 for the pixel to 
bit-field map. 



B0000H 

B3DE0H 


B4000H 

B7DE0H 


160 BYTES PER SCAN LINE 


(L HOD 4) = 0 


(L MOD 4) = 1 


B009FH 

B3E7FH 


B409FH 

B7E7FH 


B8000H 

BBDEOH 


(L HOD 4) = 2 


B809FH 

BBE7FH 



BC000H 


BC09FH 


(L MOD 4) = 3 


BFDEOH 


BFE7FH 


L = SCAN LINE 0 TO 399 

Figure 7-13 Memory Organization for 640 x 400 4-Color Mode 

6 5 4 3 2 1 0 



LEFT MOST PIXEL RIGHT MOST PIXEL 

Figure 7-14 Pixel to Bit-Field Map for 4-Color Mode 
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800 x 252 4-Color Mode 

ROM BIOS Video Mode: D2H (Limited ROM BIOS Support) - DIGITAL 
Extended 


In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-15 for the memory organization. See Figure 7-16 for the pixel to 
bit-field map. 





Figure 7-16 Pixel to Bit-Field Map for 4-Color Mode 
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Video Look-Up Table 

The video processor has a video look-up table (VLT) that translates attribute or 
graphic color data. The VLT is arranged as 16 words of IEGB output data. 

Each location corresponds to one of the 16 possible colors. When the video con¬ 
troller accesses video memory, the attributes or graphic data are used as an 
offset into the VLT. The contents of that location in the VLT are sent to the 
video output circuit. Because the VLT has only 16 entries, the VLT can alter 
the color interpretation of the bit map without rewriting every pixel. 

For 2-color mode graphics (640 x 400 or 640 x 200), the foreground color (pixel 
equals 1) is determined by the color-select register bits 3-0. The background 
color (pixel equals 0) is determined by the contents of VLT entry 0. The color 
select register is described later in this chapter. 

Normally, the VLT is accessible only to the video controller. That is, the VLT 
is not mapped into the normal CPU address space. Accessing the VLT requires 
that the video mode be one of the text modes 00H, 01H, 02H, or 03H. Bit 2 of 
control register B (described later in this chapter) controls access to the VLT. 
When bit 2 of control register B equals 1, access to the video text buffer is 
disabled and access to the VLT is enabled. 

NOTE 

Only write access to the VLT is enabled. To read the VLT in¬ 
directly, program the video processor for 320 x 200 16-color 
mode. For each of the 16 possible colors (00H-0FH): 

1. Write the same color value to each pixel. 

2. Wait until the display is inactive (register B bit 7 
equals 1) 

3. Disable CPU interrupts (CLI instruction) 

4. Wait until the display is active (register B bit 7 equals 0) 

5. Status register A bits 7-4 (IRGB) are equal to the con¬ 
tents of the VLT location specified by the color value. 

6. Enable CPU interrupts (STI instruction) 


7- 18 


Video Controller - Hardware Description 



Only even-text buffer addresses are connected to the VLT. The text buffer to 
VLT mapping appears as follows: 

Text VLT Text VLT 

Buffer Offset Buffer Offset 

Offset Offset 


B8000H 

B8001H 

0000H 

B8010H 

B8011H 

0008H 

B8002H 

B8003B 

0001H 

B8012H 

B8013H 

0009H 

B8004H 

B8005H 

0002H 

B8014H 

B8015H 

000AH 

B8006H 

B8007H 

0003H 

B8016H 

B8017H 

OOOBH 

B8008H 

B8009H 

0004H 

B8018H 

B8019H 

OOOCH 

B800AH 

B800BH 

0005H 

B801AH 

B801BH 

000DH 

B800CH 

B800DH 

0006H 

B801CH 

B801DH 

OOOEH 

B800EH 

B800FH 

0007H 

B801EH 

B801FH 

OOOFH 


Text mode attributes are referenced in the order IRGB, but the VLT ad¬ 
dressing and contents are referenced in the order RGB I. To calculate the offset 
accessed by any IRGB value, use the following bit values: 


Bit Value Attribute 


0 I (Intensity) 

1 B (Blue) 

2 G (Green) 

3 R (Red) 


Thus, a text attribute of intensified red (IRGB = COH) accesses location 09H 
of the 16 locations in the VLT. 

On power-up or system reset, the VLT is initialized to the values in Table 7-4. 
The VLT values defined in Table 7-4 support video modes 00H, 01H, 02H, 
03H, 04H, 05H, 06H and DOH. When changing from any of these modes to 
video mode D1H or D2H, initialize the VLT to the values defined in Table 7-5. 
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Table 7-4 Default VLT Contents 


Offset 
A3 A2 
R G 

A1 

B 

AO 

I 

Contents 
D3 D2 D1 
RGB 

DO 

I 

Color 

Intensity 

0 

0 

0 

0 

0 

0 

0 

0 

Black 

0 

0 

0 

0 

1 

0 

0 

0 

1 

Gray 

1 

0 

0 

1 

0 

0 

0 

1 

0 

Blue 

2 

0 

0 

1 

1 

0 

0 

1 

1 

Light blue 

3 

0 

1 

0 

0 

0 

1 

0 

0 

Green 

4 

0 

1 

0 

1 

0 

1 

0 

1 

Light green 

5 

0 

1 

1 

0 

0 

1 

1 

0 

Cyan 

6 

0 

1 

1 

1 

1 

1 

1 

0 

White 

14 

1 

0 

0 

0 

1 

0 

0 

0 

Red 

8 

1 

0 

0 

1 

1 

0 

0 

1 

Light red 

9 

1 

0 

1 

0 

1 

0 

1 

0 

Magenta 

10 

1 

0 

1 

1 

1 

0 

1 

1 

Light magenta 

11 

1 

1 

0 

0 

1 

1 

0 

0 

Brown 

12 

1 

1 

0 

1 

1 

1 

0 

1 

Yellow 

13 

1 

1 

1 

0 

0 

1 

1 

1 

Light cyan 

7 

1 

1 

1 

1 

1 

1 

1 

1 

Intense white 

15 
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Table 7-5 VLT Contents for Video Modes D1H and D2H 


Offset 
A3 A2 
R G 

A1 

B 

AO 

I 

Contents 

D3 D2 D1 
RGB 

DO 

I 

Color 

Intensity 

0 

0 

0 

0 

0 0 0 

0 

Black 

0 

0 

0 

0 

1 

0 10 

0 

Green 

4 

0 

0 

1 

0 

10 0 

0 

Red 

8 

0 

0 

1 

1 

Oil 

1 

Light cyan 

7 

0 

1 

0 

0 

Not Used 




0 

1 

0 

1 

Not Used 




0 

1 

1 

0 

Not Used 




0 

1 

1 

1 

Not Used 




1 

0 

0 

0 

Not Used 




1 

0 

0 

1 

Not Used 




1 

0 

1 

0 

Not Used 




1 

0 

1 

1 

Not Used 




1 

1 

0 

0 

Not Used 




1 

1 

0 

1 

Not Used 




1 

1 

1 

0 

Not Used 




1 

1 

1 

1 

Not Used 
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Video System Registers 

Table 7-6 lists the video processor input/output (I/O) registers. 


Table 7-6 Video Processor I/O Registers 


Address 

Width 

R/W 

Register Name 

Compatibility 

03D0H 

4-0 

W 

CRTC Index Register 

DIGITAL Extended 

03D1H 

7-0 

R/W 

CRTC Data Register 

DIGITAL Extended 

03D4H 

4-0 

W 

CRTC Index Register 

Industry-Standard 

03D5H 

7-0 

R/W 

CRTC Data Register 

Industry-Standard 

03D8H 

7-0 

W 

Control Register A 

Industry-Standard 

03D9H 

7-0 

W 

Color Select Register 

Industry-Standard 

03DAH 

7-0 

R 

Status Register A 

Industry-Standard 

03DDH 

7-0 

R 

Status Register B 

DIGITAL Extended 

03DEH 

7-0 

R 

Write Data Register 

DIGITAL Extended 

03DFH 

7-0 

W 

Control Register B 

DIGITAL Extended 

0C80H 

7-0 

R/W 

Special Purpose Register 

DIGITAL Extended 
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Special Purpose Register (0C80H) 


7 

6 

5 

4 

3 

2 

1 

0 

WRITE 

PROTECT 

TRACK 0 

INDEX 

SPEED 

DISABLE 

VIDEO 

SPLIT 

BAUD 

DISABLE 

COMM 

SPEED 

SELECT 


Bit R/W Description 


7 

6 


5 


4 


3 

2 


1 


0 


R Write protect 

0 = Selected diskette drive is not write protected 
1 = Selected diskette drive is write protected 

R Track 0 

0 = Head of selected diskette drive is not at track 0 
1 = Head of selected diskette drive is at track 0 

R Index 

0 = Index hole not in position for selected diskette drive 
1 = Index hole in position for selected diskette drive 

R Speed Indicator 

0 = Modem control speed select asserted 
1 = Modem control speed select not asserted 

R/W Disable Video 

0 = Video controller disabled 
1 = Video controller enabled 

R/W Split Baud Rates 

0 = (Receive = Transmit = programmed) 

1 = (Receive = 1200) (Transmit = programmed) 

R/W Disable Communications 

0 = Integral communications ports connected to I/O address 
space 

1 = Integral communications ports disconnected from I/O address 
space 

R/W Speed Select 

0 = Speed select asserted 
1 = Speed select not asserted 
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The special purpose register is located at I/O address 0C80H. When bit 3 
equals 0, the entire DIGITAL video system is disconnected from the memory 
and I/O address space. This allows the installation and use of industry-standard 
video adapters in the VAXmate workstation. 

If the ROM BIOS finds an industry-standard video adapter during the power- 
up sequence, the ROM BIOS clears bit 3 of the special purpose register. This 
allows the industry-standard video adapter to function without conflict. 
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CRTC Registers 

The CRT controller (CRTC) has two registers, the index and data registers, 
that are accessible in the CPU I/O space. Writing a value to the index register 
selects one of the 18 internal registers R0-R17. The selected register is read or 
written through the data register. 

Index Register (03D0H/03D4H) 


76543210 





-1-1-1-1 

REGISTER SELECT 

0 

0 

0 

RS4 RS3 RS2 RSI RSO 

_1_1_1_1_ 


Bit R/W Description 

7-5 W Always 0 

4-0 W REGISTER SELECT (RS4-RS0) 

A value between 0 and 17 written to this register selects one of 
the corresponding internal registers (R0-R17). 


Data Register (03D1H/03D5H) 


7 

6 

5 

4 

3 

2 

1 

0 



1 

§ 

* 

1 

1 

1 

D7 

D6 

D5 

J_ 

D4 

J_ 

D3 

J_ 

D2 

D1 

J_ 

DO 

J_ 


Bit R/W Description 


7-0 R/W Data and width are dependent upon the register selected by the 
index register. To determine if the data register can be read or 
written, see the description of the register selected by the index 
register. 
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The index and data registers can be accessed through two sets of I/O ports. 
The industry-standard set is 03D4H (index) and 03D5H (data). The DIGITAL 
extended set is 03D0H (index) and 03D1H (data). Data written to the industry- 
standard set pass through a translation ROM and then go to the CRTC. Data 
written to the DIGITAL extended set go directly to the CRTC. 

The translation ROM converts CRTC parameters, for an industry-standard 
color graphics adapter, to values that are correct for the extended capabilities 
of the DIGITAL video system. Thus, applications that directly program the 
CRTC of an industry-standard color graphics adapter function correctly. 

Table 7-7 lists the CRTC internal registers and their functions. Table 7-8 lists 
the corresponding parameters for the video modes defined in Table 7-1. The 
parameters listed in Table 7-8 are written to the CRTC through the DIGITAL 
extended I/O ports 03D0H (index) and 03D1H (data). 


Table 7-7 CRTC Internal Registers 


Register 

Index 

R/W 

Description 

RO 

00H 

W 

Horizontal total 

R1 

01H 

w 

Horizontal displayed 

R2 

02H 

w 

Horiz sync position 

R3 

03H 

w 

Sync width 

R4 

04H 

w 

Vertical total 

R5 

05H 

w 

Vertical total adjust 

R6 

06H 

w 

Vertical displayed 

R7 

07H 

w 

Vertical sync position 

R8 

08H 

w 

Interlace/Skew 

R9 

09H 

w 

Max scan line address 

RIO 

OAH 

w 

Cursor start 

Rll 

OBH 

w 

Cursor end 

R12 

OCH 

R/W 

Start address (High byte) 

R13 

ODH 

R/W 

Start address (Low byte) 

R14 

OEH 

R/W 

Cursor address (High byte) 

R15 

OFH 

R/W 

Cursor address (Low byte) 

R16 

10H 

R 

Light pen (High byte) * 

R17 

11H 

R 

Light pen (Low byte) * 


* The DIGITAL video system does not support light pens. 
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Table 7-8 

CRTC Register Values 









320 x 

200 

4-color 






640 x 

640 x 






400 

200 






4-color 

2-color 




320 x 

800 x 

640 x 

640 x 




200 

252 

200 

400 




16-color 

4-color 

4-color 

2-color 

80x25 

40 x 25 

Register 

Graphics 

Graphics 

Graphics 

Graphics 

Text 

Text 

RO 

69H 

83H 

69H 

34H 

69H 

34H 

R1 

50H 

64H 

50H 

28H 

50H 

28H 

R2 

58H 

6DH 

58H 

2CH 

58H 

2DH 

R3 

58H 

5AH 

58H 

54H 

58H 

54H 

R4 

36H 

6DH 

6DH 

6DH 

1AH 

1AH 

R5 

00H 

01H 

OOH 

OOH 

08H 

08H 

R6 

32H 

3FH 

64H 

64H 

19H 

19H 

R7 

33H 

53H 

66H 

66H 

19H 

19H 

R8 

40H 

40H 

42H 

40H 

40H 

40H 

R9 

07H 

03 H 

03H 

03H 

OFH 

OFH 

RIO 

00H 

OOH 

OOH 

OOH 

OOH 

OOH 

Rll 

OFH 

OFH 

OFH 

OFH 

OFH 

OFH 

R12 

00H 

OOH 

OOH 

OOH 

OOH 

OOH 

R13 

00H 

OOH 

OOH 

OOH 

OOH 

OOH 

R14 

OOH 

OOH 

OOH 

OOH 

OOH 

OOH 

R15 

00H 

OOH 

OOH 

OOH 

OOH 

OOH 
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Register RO 

76543210 
-,-,-,- 1 - 1 - 1 - 1 - 

HORIZONTAL TOTAL 

_I_I_I_I_I_I_I_ 


Bit R/W Description 


7-0 W HORIZONTAL TOTAL 

This register determines the horizontal synchronization frequency. 
It is the number of displayed characters (Rl) plus the retrace (in 
character times) minus one. 


Register Rl 

76543210 

HORIZONTAL DISPLAYED 

_I_I_I_I_I_I_I_ 


Bit R/W Description 


7-0 W HORIZONTAL DISPLAYED 

This register determines the number of displayed characters on a 
line. The value in Rl must be less than the value in RO. 


7- 28 


Video Controller - Hardware Description 








Register R2 

76543210 
- 1 - 1 - 1 - 1 - 1 - 1 - 1 - 

HORIZONTAL SYNCHRONIZATION POSITION 

_I_I_I_I_I_I_I_ 


Bit R/W Description 


7-0 W HORIZONTAL SYNCHRONIZATION POSITION 

This register determines the position of the horizontal synchroniza¬ 
tion delay and the horizontal scan delay. When this value is in¬ 
creased, the display shifts left. When this value is decreased, the 
display shifts right. 


Register R3 


7 

6 5 

4 

3 

2 10 

VERTICAL SYNCHRONIZATION 
PULSE WIDTH 

HORIZONTAL SYNCHRONIZATION 
PULSE WIDTH 

VS3 

l 

VS2 VS1 

l 

VSO 

HS3 

HS2 HS1 HS0 

l 1 

Bit R/W 

Description 





7-4 W VERTICAL SYNCHRONIZATION PULSE WIDTH 


A value of 1-15 produces a pulse width of the indicated number of 
scan-line periods. A value of zero produces a pulse width of 16 
scan-line periods. 

3-0 W HORIZONTAL SYNCHRONIZATION PULSE WIDTH 

A value of 1-15 produces a pulse width of the indicated number of 
character periods. If the value equals 0, then a horizontal synchro¬ 
nization pulse is not provided. 
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Register R4 


7 

6 5 

4 3 2 

1 

0 

0 

1 1 1 1 1 I 

VERTICAL TOTAL 

_1__l_1_1_1_1_ 

Bit R/W 

Description 





7 W Always 0 

6-0 W VERTICAL TOTAL 


This value determines the vertical synchronization frequency. It is 
the number of displayed character lines plus the retrace (in charac¬ 
ter line times) minus one. 


Register R5 

7 6 

5 

4 

3 2 1 

0 

0 

0 

0 

1 1 1 1 

VERTICAL TOTAL ADJUST 

_1_1_1_1_ 

Bit R/W 

Description 





7-5 W Always 0 

4-0 W VERTICAL TOTAL ADJUST 


This value is the number of scan-line periods required, in addition 
to R4, to produce a vertical synchronization frequency of exactly 
50Hz or 60Hz. 
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Register R6 


76543210 




I- 1 - 1 - 1 - 1- 1 - 

VERTICAL DISPLAYED 


0 

1 1 1 1 1 1 

Bit 

R/W 

Description 

7 

W 

Always 0 

6-0 

w 

VERTICAL DISPLAYED 



This value specifies the number of displayed character lines. It 
must be less than the value in R4. 

Register 

R7 


7 

6 5 4 3 2 1 0 



1 I i i i 1 

VERTICAL SYNCHRONIZATION POSITION 


0 

1 1 1 1 1 1 

Bit 

R/W 

Description 

7 

w 

Always 0 

6-0 

w 

VERTICAL SYNCHRONIZATION POSITION 



This value determines the position of the vertical synchronization 
delay and the vertical scan delay. When this value is increased, the 
display shifts up. When this value is decreased, the display shifts 
down. 
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Register R8 


7 

6 

5 4 

3 

2 

1 

0 

i 

CURSOR 

SKEW 

DISPLAY* ENABLE 
SKEW 



i 

INTERLACE NODE 

CS1 

1 

CSO 

DS1 DSO 

_1_ 

0 

0 

INI 

_ 1 

INO 

_ 


Bit E/W Description 


7-6 

W 

CURSOR SKEW 



00 = 

No skew 



01 = 

One character skew 



10 = 

Two character skew 



11 = 

Invalid value 

5-4 

W 

DISPLAY ENABLE SKEW 



00 = 

No skew 



01 = 

One character skew 



10 = 

Two character skew 



11 = 

Invalid value 

3-2 

W 

Always 0 

1-0 

W 

INTERLACE MODE 



00 = 

Normal mode 



01 = 

Interlace synchronization mode 



10 = 

Normal mode 



11 = 

Interlace synchronization and video mode 
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Register R9 


76543210 





-1— 

-1-1- 

-1- 





MAXIMUM SCAN LINE 


0 

0 

0 

_1_ 

_1_1_ 

_J_ 


Bit R/W Description 

7-5 W Always 0 

4-0 W MAXIMUM SCAN LINE 

This value specifies one less than the number of scan lines per 
character line including spacing. 


Register RIO 


7 

6 5 

4 

3 2 1 

0 

0 

CURSOR DISPLAY 
MODE 

l 

1 

i 4 

CURSOR START 

I I l 

i 

Bit R/W 

Description 





7 W Always 0 


6-5 W CURSOR DISPLAY MODE 

00 = Nonblinking cursor 
01 = Cursor not displayed 

10 = Blinking cursor (3.75 Hz) 

11 = Blinking cursor (1.875 Hz) 

4-0 W CURSOR START 


This value specifies the scan line, within the character cell, on 
which the cursor starts. A value of 0 starts the cursor at the top 
of the character cell. 


This register is meaningful only in text video modes. 
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Register Rll 

76543210 





CURSOR END 

0 

0 

0 

_1_1_1_1_ 


Bit R/W Description 

7-5 W Always 0 

4-0 W CURSOR END 

This value specifies the scan line, within the character cell, on 
which the cursor ends. A value of 15 ends the cursor at the 
bottom of the character cell. 


This register is meaningful only in text video modes. 
Register R12 


7 

6 

5 

4 

3 2 

1 


0 





1 1 1 


1 


0 

0 


1_ 

START ADDRESS 
HIGH BYTE 

J_1_L 


1 



Register R13 

76543210 


1-1-1- 

* * 

-1- 

1 

START 

ADDRESS 



LOW 

BYTE 



_1_1_1_ 

J_ 1 _ 

_1 

_1_ 


R12 and R13 are a write-only register pair that determine which part of the 
video RAM is used to generate the display. The address in R12 and R13 must 
be an even value. This address points to the first character position. 
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Register R14 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 


1 

i 

CURSOR 

HIGH 

1 

T ,_ 

ADDRESS 

BYTE 

1 



Register R15 







7 

6 

5 

4 

3 

2 

1 

0 


_ 1 

i 

1 _ 

CURSOR 

LOW 

_1 _ 

i i 

ADDRESS 

BYTE 

J_1 

i l 

1_L_ 

1 

1 

1 

1 


R14 and R15 are a read/write register pair that determine the location of the 
cursor as an offset from the beginning of video RAM. The address in R14 and 
R15 must be an even value. The address points to the character byte of a char¬ 
acter byte/attribute byte pair. 


Video Controller - Hardware Description 7-35 









Register R16 


7 

6 

5 

4 3 2 

1 

0 

0 

0 


1 T " l 1 

LIGHT PEN POSITION 
HIGH BYTE 

1 1 1 1 


1 

1 

Register R17 





7 

6 

5 

4 3 2 

1 

0 

i i 

_1_ 1 

i 

1 _ 

l i i i 

LIGHT PEN POSITION 

LOW BYTE 

_l_1_1_1 


1 

_J_ 


R16 and R17 are a read only register pair that capture the CRTC refresh ad¬ 
dress when the light pen strobe pin is pulsed. 


NOTE 

The VAXmate workstation does not support the use of light 
pens. 
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Status Register A (03DAH) 

76543210 


VIDEO 

VIDEO 

VIDEO 

VIDEO 

VSINC 

-1- 

LIGHT PEN 

RETRACE 

I 

R 

G 

B 


_1_ 



Bit R/W Description 


7 R VIDEO I - Video Intensity Signal 

0 = Video intensity signal inactive 
1 = Video intensity signal active 

6 R VIDEO R - Video Red Signal 

0 = Video red signal inactive 
1 = Video red signal active 

5 R VIDEO G - Video Green Signal 

0 = Video green signal inactive 
1 = Video green signal active 

4 R VIDEO B - Video Blue Signal 

0 = Video blue signal inactive 
1 = Video blue signal active 

3 R VSYNC - Vertical Synchronization 

0 = Vertical synchronization inactive 
1 = Vertical synchronization active 

2-1 R LIGHT PEN (Contents undefined) 

0 R RETRACE (Horizontal or vertical) 

0 = Display active 
1 = Retrace period 

Because the dual-port RAM eliminates display interference caused 
by accessing video memory, checking this bit is not required. For 
those programs that do check, this bit flips with each read. 

Because a retrace period appears to be in effect every other time it 
is checked, this has the effect of speeding up video memory 
accesses. 
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Status Register B (03DDH) 

76543210 


VIDEO 

CR-B3 

CR-B5 

CR-A4 

CR-A1 

CR-AO 

WRITE 

PORT 

BLANK 






CHECK 

CHECK 


Bit R/W Description 

7 R VIDEO BLANK 

0 = Video is in an active display state 
1 = Video is in a blanking state 

6 R CR-B3 

Control Register B bit 3 (Display enabled) 

5 R CR-B5 

Control Register B bit 5 (Control register A bit 3 enable) 

4 R CR-A4 

Control Register A bit 4 (Mode bit 2) 

3 R CR-A1 

Control Register A bit 1 (Mode bit 1) 

2 R CR-AO 

Control Register A bit 0 (Mode bit 0) 

1 R WRITE CHECK 

0 = Since the write data register (03DEH) was last read, an I/O 
write to port 03D4H or 03D5H has not occurred. 

1 = Since the write data register (03DEH) was last read, an I/O 
write to port 03D4H or 03D5H has occurred. This bit is 
cleared by reading the write data register (03DEH). 

0 R PORT CHECK 

0 = Of the pair, 03D4H and 03D5H, 03D4H was the last port 
written. 

1 = Of the pair, 03D4H and 03D5H, 03D5H was the last port 
written. 

This bit is used in conjunction with bit 1. 
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3 


2 


1 


0 


Write Data Register (03DEH) 

7 6 5 4 










Bit R/W 

Description 






7-0 R 

Contains the last data written into the CRTC through register 
03D4H or 03D5H. Status register B bits 1-0 indicate which port 
the data was written to. Reading this register clears status register 
B bit 1. 

Color Select Register (03D9) 

7 6 5 4 

3 

2 

1 

0 



CPS 

SIC 

i 

I 

R 

G 

B 

0 

0 







Bit R/W 

Description 







7-6 

W 

Always 0, always ignored 

5 

W 

CPS - Color Palette Select (See Table 7-9 and Table 7-10) 

4 

w 

SIC - Select Intensified Colors (See Table 7-9 and Table 7-10) 

3 

w 

I - Intensity (See Table 7-9) 

2 

w 

R - Red (See Table 7-9) 

1 

w 

G - Green (See Table 7-9) 

0 

w 

B - Blue (See Table 7-9) 
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The use of the color select register bits depends on the current video mode. 
Table 7-9 describes the bit meanings for the affected modes. Table 7-10 
describes the color palettes selected by bits 5-4 (CPS and SIC). 


Table 7-9 Color Select Register Bit Assignments 


Bit 

Text Modes 

320 x 200 
4-Color 

Graphics 

640 x 200 x 2-Color 

640 x 400 x 2-Color 

Graphics 

7 

Ignored 

Ignored 

Ignored 

6 

Ignored 

Ignored 

Ignored 

5 

Ignored 

CPS 

Ignored 

4 

Ignored 

SIC 

Ignored 

3-0 

Border color 

Border and 
background 
color 

Foreground color 


NOTE 

For the VAXmate workstation, the border color is always black. 


Table 7-10 

Color Palettes Selected by CPS and SIC 


Color 

cbl 

Bit 

cbO 

CPS = 0 

SIC = 0 

CPS = 1 

SIC = 0 

CPS = 0 

SIC = 1 

CPS = 1 

SIC = 1 

0 

0 

Background 

Background 

Background 

Background 

0 

1 

Green 

Cyan 

Light green 

White 

1 

0 

Red 

Magenta 

Light red 

Light magenta 

1 

1 

Brown 

Light cyan 

Light yellow 

Intense white 


The color bits (cbl/cbO) in Table 7-10 are any 2 bits that describe a pixel color 
in the 320 x 200 4-color video mode. 


7- 40 


Video Controller - Hardware Description 








Control Register A (03D8H) 

76543210 




BLINK 

MODE 

DISPLAY 


MODE 

MODE 



ENABLE 

BIT 2 

ENABLE 


BIT 1 

BIT 0 

0 

0 




0 




Bit R/W Description 


7-6 

W 

Always 0 

5 

W 

BLINK ENABLE 

0 = Text mode background intensity bit (I) remains in effect 

1 = Text mode background intensity bit (I) becomes blink bit 

4 

W 

MODE BIT 2 (See Table 7-11) 

3 

W 

DISPLAY ENABLE 



If control register B (03DFH) bit 5 equals 0, this bit is ignored. If 
control register B bit 5 equals 1, the following is true: 

0 = Display disabled 

1 = Display enabled 

2 

W 

Always 0 (Reserved) 

1 

W 

MODE BIT 1 (See Table 7-11) 

0 

w 

MODE BIT 0 (See Table 7-11) 
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Table 7-11 lists the video modes selected by the mode bits in control registers 
A and B. 


Table 7-11 Selecting Video Modes 


Control 
Register A 
Mode Bits 

2 10 

Control 
Register B 
Bit 

7 

Mode 

Compatibility 

0 0 0 

0 

40 x 25 Text 

Industry-standard 

0 0 1 

0 

80 x 25 Text 

Industry-standard 

0 10 

0 

320 x 200 x 4 
color graphics 

Industry-standard 

0 1 1 

0 

320 x 200 x 16 
color graphics 

DIGITAL extended 

10 0 

0 

640 x 400 x 2 
color graphics 

DIGITAL extended 

1 0 1 


640 x 200 x 4 
color graphics 

DIGITAL extended 

1 1 0 

0 

640 x 200 x 2 
color graphics 

Industry-standard 

111 

0 

640 x 400 x 4 
color graphics 

DIGITAL extended 

1 1 1 

1 

800 x 252 x 4 
color graphics 

DIGITAL extended 


7- 42 


Video Controller - Hardware Description 





Control Register B (03DFH) 


7 

6 

5 

4 

3 

2 

1 

0 

MONITOR 

MODE 

SCREEN 

SAVER 

CR-A5 

ENABLE 

PONT 

RAM 

ENABLE 

DISPLAY 

ENABLE 

VLT 

ENABLE 

0 

0 


Bit R/W Description 


7 

W 

MONTIOR MODE 

0 = 400 scan lines 

1 = 252 scan lines 

6 

W 

SCREEN SAVER 



Toggling this bit to 0 and then back to 1 blanks the display. The 
next memory or I/O access to the video address space reenables 
the display. Program to 1 for normal operation. 

5 

W 

CR-A5 ENABLE 

0 = Control register A bit 5 ignored 

1 = Control register A bit 5 enabled 

4 

W 

FONT RAM ENABLE 

0 = Access to font RAM disabled 

1 = Access to font RAM enabled 

3 

W 

DISPLAY ENABLE 

0 = Display blanked 

1 = Display enabled 

2 

W 

VLT ENABLE 

0 = Access to video look-up table disabled 

1 = Access to video look-up table enabled 

1-0 

W 

Always 0 


Video Controller - Hardware Description 7-43 















Monitor Interface 

Table 7-12 lists the monitor interface signals. These signals are applicable to 
both a monochrome or a color monitor. 


Table 7-12 

Monitor Interface Signals 

Pin No. 

Signal Description 

1 

Horizontal synchronization (active low) 

2 

Vertical synchronization (active low) 

3 

Intensity Video (active high) 

4 

Red Video (active high) 

5 

Green Video (active high) 

6 

Blue Video (active high) 

7 

400/252 select (low for 400 scans; high for 252 scans) 

8 

(reserved) 

9 

Signal ground 

10 

+5 return 

11 

+ 5V dc (200 mA max.) 

12 

(spare) 


Monitor Specification Summary 

The following are specifications for the monochrome monitor on the VAXmate 
workstation: 


CRT 

Active Display 
Resolution 

Horizontal scan rate 

Vertical scan rate 
Video Bandwidth 


340 mm (14 in) diagonal, amber or green phosphor 

240 mm horizontal by 150 mm vertical (9.5 x 6 in) 

640 pixels horizontal by 400 pixels vertical 
800 pixels horizontal by 252 pixels vertical 

26.40 kHz (640 x 400) 

26.49 kHz (800 x 252) 

60 Hz noninterlaced 

22.384 MHz (640 x 400) 

27.984 MHz (800 x 252) 
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Programming Example 

The following programming example demonstrates: 

• Programming the video controller for a specific mode 

• Writing the video look-up table 

• Reading and writing the font RAM 

• Displaying characters in text and graphics modes 

NOTE 

Whenever possible, ROM BIOS Interrupt 10H video calls are 
preferred over direct programming of the video hardware. 

Do not mix ROM BIOS calls and direct programming of the 
hardware. 

Before directly programming the hardware, use ROM BIOS calls 
to determine the state of the video system. On exit, use the 
ROM BIOS to restore the previous state. 

CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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The example provides routines as described in the following list: 


getmodep 

get_mess_p 

w_vlt 

r_w_font 

mode_init 

mv_cursor 

cursor_on 

cursoroff 

setmode 

screenon 

clear_vid_mem 

do border 


dispg 

disp_t 

video 


Returns a pointer to a table of data about the indicated mode. 

Returns a pointer to character string that describes the indi¬ 
cated mode. 

Writes the video look-up table. 

Reads or writes the font ram. 

Initializes the video controller and mode registers from a table 
of data. 

Positions the cursor to the indicated row and column position. 
Positions the cursor and makes it visible. 

Makes the cursor invisible. 

Sets the current mode, clears video memory and enables the 
display. 

Enables or disables the display. 

Clears the screen by writing the appropriate values to video 
memory. 

Forms a border around the screen (like a picture frame), by 
displaying the letter E at the extreme positions of the screen. 
It also displays a message, in the center of the screen, that 
describes the current mode. 

Displays, in graphics mode, the pixel representation of a 
character. 

Displays characters for text mode. 

Sets up the conditions and executes the examples. 
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The constants defined in this example are in the include file VIDEO.H. 

The other include files, EXAMPLE.H and KYB.H, support the example, but 
are not pertinent to the video section. 

The constant values TRUE and FALSE are used as calling parameters for sev¬ 
eral routines. 

The constant values CRTC_INDEX through CTRL_REGB define the ad¬ 
dresses, in input/output space, of the registers used to control the video mode 
and attributes. These registers are described in Table 7-7. 

The constant value VB8 defines the industry-standard start address for color 
graphics video memory. The constant value VBO defines the VAXmate ex¬ 
tended start address for color graphics video memory. These values are far 
pointers expressed as long integers. 

The structure type VLT defines the organization of the video look-up table. 
When access is enabled, the first byte of the video look-up table is written at 
B800H:0000H (segment:offset). The next byte is written at B800H:0002H (seg- 
ment:offset). Thus, the video look-up table can be defined as an array of 16 
structures of type VLT. Notice that this organization should be used only for 
accessing the video look-up table. It should not be used when reserving space, 
because 50 percent of the space would be wasted. 

The structure type FONT defines the organization of the font RAM. When 
access is enabled, the first byte of the font RAM is read or written at 
B8OOH:0OOOH (segment:offset). The next byte is read or written at 
B800H:0002H (segment:offset). Each character font requires 16 bytes. The font 
for each of the possible 256 characters can be defined. Thus, the font RAM can 
be defined as a two-dimensional array of structures of type FONT, where the 
first subscript is 256 and the second subscript is 16. Notice that this organiza¬ 
tion should be used only for accessing the font RAM. It should not be used 
when reserving space, because half the space would be wasted. 

The structure type M_TABLE defines data or pointers to data that is required 
to program the various video modes. Later in the example, an array of struc¬ 
tures of type M_TABLE is defined. The values used are gathered from infor¬ 
mation provided earlier in this chapter. 
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#include "video.h" 

#include "example.h" 

#include "kyb.h" 

./***********************************************************************/ 
/* Declare constants and structures used in examples */ 

/***********************************************************************/ 


#define 

TRUE 

Oxffff 


/* True is nonzero * 

►/ 

#define 

FALSE 

0x0000 


/* False is zero 

*/ 

#define 

CRTCLINDEX 

0x03d0 

/* 

crtc index register in i/o space 

*/ 

#define 

CRTCLDATA 

0x03dl 

/* 

crtc data register in i/o space 

*/ 

#define 

CTRL_REGA 

0x03d8 

/* 

control register A in i/o space 

*/ 

#define 

COLR.SELC 

0x03d9 

/* color select register in i/o space 

*/ 

#define 

STAT_REGA 

0x03da 

/* 

status register A in i/o space 

*/ 

#define 

STAT_REGB 

0x03dd 

/* 

status register B in i/o space 

*/ 

#define 

CTRL_REGB 

0x03df 

/* 

control register B in i/o space 

*/ 

#define 

VB8 0xb8000000L 

/* normal base address of video memory 

*/ 

#define 

VBO OxbOOOOOOOL 


/* extended base address 

*/ 

typedef 

struct 





. V 

unsigned char 

vlt_byte; 


/* vlt entries at even address 

*/ 

unsigned char 

skip_byte; 


/* skip byte at odd address 

*/ 

> VLT; 







typedef struct 


t 

unsigned char 

font_byte; 

/* font entries at even 

address 

*/ 

unsigned char 

skip_byte; 

/* skip byte at odd 

address 

*/ 


} FONT; 

typedef struct 
< 


unsigned 

char 

*ct; 

/* pointer into crtc_table 

*/ 

unsigned 

char 

*vt; 

/* pointer into vltstable 

.*/ 

unsigned 

char 

era; 

/* control register A value (Table 7^11) 

*/ 

unsigned 

char 

erb; 

/* control register B value 

*/ 

unsigned 

char 

csr; /* 

color select register value (Table 7-10) 

*/ 

long 


base; 

/* segment:offset base address 

*/ 

unsigned 

int 

nsp; 

/* number of scan pages 

*/ 

unsigned 

int 

sps; 

/* scan page size 

*/ 

unsigned 

int 

cb; 

/* color bits per pixel 

*/ 

unsigned 

int 

width; 

/* bytes per character line or scan line 

*/ 

unsigned 

.TABLE; 

int 

length; 

/* in chars or pixels depending on mode 

*/ 
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The array crtc defines six sets of CRT controller initialization values. The 
values used are those listed in Table 7-8, which supports all of the defined 
VAXmate video modes. Notice that each state supports more than one video 
mode. In that case, the distinguishing factor is the contents of control register 
A, control register B, the color select register and the video look-up table. 

These relationships are demonstrated later in the mode_table definition. 

The array vlts defines two sets of video look-up table initialization values. The 
values used are those listed in Table 7-4 and Table 7-5. Notice that each state 
supports more than one video mode. These relationships are demonstrated later 
in the mode_table definition. 

The array modejist is not required to program the video modes, however, the 
example uses this array to index through the various modes as it performs the 
demonstration. 

NOTE 

The two video modes, Oxfe and Oxff, are not defined or sup¬ 
ported by the ROM BIOS. The mode numbers, Oxfe and Oxff, 
are defined only within the limits of this example. 


7- 50 


Video Controller - Programming Example 



/***********************************************************************/ 

/* Define table values and declare globals used in examples */ 

/:*:k*******$**********$:>l'**9|c**********:k*$:**:*******:*************:4'*3!'3|'’ic)|<**’l':>l')|'/ 


unsigned char 
/ 

crtc[6][16] 

= 

/* 1 

Refer 

to Table 

7-7 A 7-8 */ 


{ 0x34, 

0x28, 

0x2d, 

0x54, 

Oxla, 

0x08, 

0x19, 

0x19, 

/* TEXT 

*/ 

0x40, 

OxOf, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 40 x 25 

*/ 

{ 0x69, 

0x50, 

0x58, 

0x58, 

Oxla, 

0x08, 

0x19, 

0x19, 

/* TEXT 

*/ 

0x40, 

OxOf, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 80 x 26 

*/ 

{ 0x34, 

0x28, 

0x2c, 

0x54, 

0x6d, 

0x00, 

0x64, 

0x66, 

/* GRAPHICS 

*/ 

0x40, 

0x03, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 320 x 200 x 4 

*/ 









/* 640 x 200 x 2 

*/ 









/* 640 x 400 x 2 

*/ 

{ 0x69, 

0x50, 

0x58, 

0x58, 

0x6d, 

0x00, 

0x64, 

0x66, 

/* GRAPHICS 

*/ 

0x42, 

0x03, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 640 x 400 x 4 

*/ 









/* 640 x 200 x 4 

*/ 

{ 0x83, 

0x64, 

0x6d, 

0x5a, 

0x6d, 

0x01, 

Ox3f, 

0x53, 

/* GRAPHICS 

*/ 

0x40, 

0x03, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 800 x 250 x 4 

*/ 

{ 0x69, 

0x50, 

0x58, 

0x58, 

0x36, 

0x00, 

0x32, 

0x33, 

/* GRAPHICS 

*/ 

0x40, 

0x07, 

0x00, 

OxOf, 

0x00, 

0x00, 

0x00, 

0x00 >, 

/* 320 x 200 x 16 

*/ 


>; 


unsigned char vlts[2][16] = 
< 


{ 0x00, 

0x01, 

0x02, 

0x03, 

/* See Table 7-4 

*/ 

0x04, 

0x05, 

0x06, 

OxOe, 



0x08, 

0x09, 

OxOa, 

OxOb, 



OxOc, 

OxOd, 

0x07, 

OxOf >, 



{ 0x00, 

0x04, 

0x08, 

0x07, 

/8 See Table 7-5 

*/ 

0x00, 

0x00, 

0x00, 

0x00, 



0x00, 

0x00, 

0x00, 

0x00, 



0x00, 

0x00, 

0x00, 

0x00 >, 




>; 

int mode_list[12] = { 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 

0x06, OxdO, Oxdl, 0xd2, Oxfe, Oxff >; 
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The array modejable is an array of structures of type M_TABLE. Each struc¬ 
ture contains data or pointers to data that are required to program a particular 
video mode. Refer back to the declaration of the structure type M_TABLE to 
determine the relative placement or meaning of each value. The base address, 
number of scan pages, color bits per pixel, and width are determined from 
Figure 7-3 through Figure 7-16. 

The array message is not required to program the video modes, however, the 
example program uses a string from the array message to identify and confirm 
the current video mode. The appropriate string is determined by the function 
getjness _p. 

The array rltr_e defines the character font for a reverse (mirror image) letter 
‘E\ It is used to demonstrate writing the font RAM and the effect it has. The 
character cell size is 8 x 16. 

The array c Jont reserves enough space to store the font for an entire charac¬ 
ter set (256 characters having a cell size of 8 x 16). The example program 
copies the current contents of the font RAM to this space. 

The variable font_h allows the program to dynamically change, between 
demonstrations, the height of the character font. The variable font_w is pro¬ 
vided for consistency. 

The variable vid mode allows the currently selected mode to be known globally. 
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MUTABLE mode.table[13] = 
< 


{ ftcrtc[0][0], 

&vlts[0], 

0x08, 

0x68, 

0x00, 

VB8, 

8, 

0x0400, 

0x04, 

40, 

25 >, 

{ fccrtc[0][0], 

&vlts[0], 

0x08, 

0x68, 

0x00, 

VB8, 

8, 

0x0400, 

0x04, 

40, 

25 >, 

{ Acrtc[l][0], 

Avlts[0], 

0x09, 

0x68, 

0x00, 

VB8, 

4. 

0x0800, 

0x04, 

80, 

26 }, 

{ fccrtc[1][0], 

ftvlts[0], 

0x09, 

0x68, 

0x00, 

VB8, 

4, 

0x0800, 

0x04, 

80, 

25 >, 

{ &crtc[2][0], 

ftvlts[0], 

0x0a, 

0x68, 

0x00, 

VB8, 

2, 

0x2000, 

0x02, 

80, 

200 >, 

{ fccrtc[2][0], 

Avlts[0], 

0x0a, 

0x68, 

0x00, 

VB8, 

2, 

0x2000, 

0x02, 

80, 

200 >, 

{ &crtc[2][0], 

&vlts[0], 

Oxla, 

0x68, 

0x07, 

VB8, 

2, 

0x2000, 

0x01, 

80, 

200 >, 

{ ftcrtc[2][0], 

&vlts[0], 

0x18, 

0x68, 

0x07, 

VB8, 

4, 

0x2000, 

0x01, 

80, 

400 >, 

< fccrtc[3][0], 

&vlts[l], 

Ox lb, 

0x68, 

0x00, 

VBO, 

4. 

0x4000, 

0x02, 

160, 

400 >, 

{ ftcrtc [4] [0], 

fcvlts[1], 

Oxlb, 

0xe8, 

0x00, 

VBO, 

4, 

0x4000, 

0x02, 

200, 

250 >, 

{ fccrtc[5][0], 

&vlts[0], 

0x0b, 

0x68, 

0x00, 

VB8, 

4. 

0x2000, 

0x04, 

160, 

200 >, 

< &crtc[3][0], 

*vlts[l], 

0x19, 

0x68, 

0x00, 

VB8, 

2, 

0x4000, 

0x02, 

160, 

200 >, 


>; 


char message[12][24] = 
{ 


tf 

40 

X 

25 

monochrome” 

(t 

40 

X 

25 

color”, 

fl 

80 

X 

25 

monochrome" 

ft 

80 

X 

25 

color", 

fl 

320 

X 

200 

x 4-color”, 

ft 

320 

X 

200 

monochrome” 

ft 

640 

X 

200 

x 2-color", 

ff 

640 

X 

400 

x 2-color”, 

ft 

640 

X 

400 

x 4-color”, 

fl 

800 

X 

250 

x 4-color”, 

ft 

320 

X 

200 

x 16-color”, 

ff 

640 

X 

200 

x 4-color”, 


>; 

char press [32] = "Press any function key to exit"; 

char rltr_e[16] = { 0x00, 0x00, Oxfe, 0x02, 0x02, 0x02, 0x7e, 0x02, 

0x02, 0x02, 0x02, Oxfe, 0x00, 0x00, 0x00, 0x00 >; 

char c_font[2B6][16]; /* space to store current character set */ 

char c_cursor[8] = { Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff > ; 


int font_w = 8; 
int font_h = 16; 
int vid_mode = 2; 


/* font width in pixels */ 
/* font height in pixels */ 
/* current video mode */ 


Video Controller - Programming Example 7-53 



The function getjnode_p provides a single source for a pointer to video mode 
data. 


NOTE 

The two video modes, Oxfe and Oxff, are not defined or sup¬ 
ported by the ROM BIOS. The mode numbers, Oxfe and Oxff, 
are defined only within the limits of this example. 

The function getjness_p provides a single source for a pointer to a string that 
describes the currently selected video mode. This function is not required to 
program the video modes, however, it is used to support the example program. 
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/* ste*********************************************************^***********/ 

/* get_mode_p() - returns a pointer to a mode table */ 

MUTABLE *get_mode_p(d_mode) /* get mode table pointer */ 


int d_mode; 

{ 


switch(d_mode) 

{ 

case 0: return(&mode_table[0]); 

case 1: return(&mode_table[1]); 

case 2: return(&mode_table[2]); 

case 3: return(&mode_table[3]); 

case 4: return(&mode_table[4]); 

case 5: return(&mode_table[5]); 

case 6: return (&mode__table [6]) ; 

case OxdO: return(&mode__table[7]) ; 

case Oxdl: return(&mode_table[8]); 
case 0xd2: return(&mode_table [9] ); 
case Oxfe: return(&mode_table[10]); 
case Oxff: return(&mode_table[11]); 

> 

> 


/* desired mode */ 
/* discover desired mode */ 


/* 

40 x 

25 

monochrome 

*/ 


/* 

40 x 

25 

color 

*/ 

/* 

80 > 

c 

25 

monochrome 

*/ 


/* 


80 x 

25 

color 

*/ 

/* 

320 

X 

200 

x 4 

color 

*/ 

/* ; 

320 x 

200 

monochrome 

*/ 

/* 

640 

X 

200 

x 2 

color 

*/ 

/* 

640 

X 

400 

x 2 

-color 

*/ 

/* 

640 

X 

400 

x 4- 

-color 

*/ 

/* 

800 

X 

250 

x 4- 

-color 

*/ 

/* 

320 

X 

200 

x 16 

-color 

*/ 

/* 

640 

X 

200 

x 4- 

-color 

*/ 


/* get_mes8_p() returns a pointer to a string that describes the mode */ 
char *get_mess_p() /* get message pointer */ 

switch(vid_mode) /* discover current mode */ 

i 

case 0: return(^message[0][0]); /* 40 x 25 monochrome */ 

case 1: return(^message[1][0]); /* 40 x 25 color */ 

case 2: return(^message[2][0]); /* 80 x 25 monochrome */ 

case 3: return(^message[3][0]); /* 80 x 25 color */ 

case 4: return(^message[4][0]); /* 320 x 200 x 4 color */ 

case 5: return(^message[5][0]); /* 320 x 200 monochrome */ 

case 6: return(^message[6][0]); /* 640 x 200 x 2 color */ 

case OxdO: return(^message[7][0]); /* 640 x 400 x 2-color */ 

case Oxdl: return(&message[8][0]); /* 640 x 400 x 4-color */ 

case 0xd2: return(^message[9][0]); /* 800 x 250 x 4-color */ 

case Oxfe: return(&message[10][0]); /* 320 x 200 x 16-color */ 

case Oxff: return(^message [11][0] ); /* 640 x 200 x 4-color */ 

> 

> 


Video Controller - Programming Example 7-55 







The function wjult writes the video look-up table. 

The parameter pva is a pointer to a packed array of byte values. 

Notice that the routine waits until the start of video blanking time to perform 
the operation and that video output is disabled on return. 

/* w_vlt() - copies a set of vlt-values to the video look-up table */ 

/I***********************************************************************/ 


void w.vlt(pva) 
register char *pva; 

register int i; 

VLT far *pvlt; 

pvlt = (VLT far *)VB8; 
while(inp(STAT_REGB) k 0x80) 

t 

while(inp(STAT_RE6B) k 0x80 == 0) 

f 

outp(CTRL__REGB, 0x04) ; 
for(i = 0; i < 16; i++) 

vlt_byte « *pva++; 
outp(CTRL.REGB, 0); 

} 


/* write vlt */ 
/* ptr to array of characters */ 


/* loop counter */ 
/* pointer to access vlt */ 

/* initialize pointer to vlt */ 
/* wait until display is active */ 

/* wait until beginning of */ 
/* display blanked */ 
/* enable vlt access */ 
/* do all 16 vlt values */ 

(pvlt++)-> 

/* write to vlt */ 

/* return to normal */ 
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The function r_ioJont reads or writes the font RAM. If the parameter dir is 
false, it reads from the font RAM. Otherwise, it writes to the font RAM. 

The parameter pfa is a pointer to a packed array of byte values. 

Notice that to access the font RAM, the current mode must be one of the text 
modes. The mode is changed temporarily and then restored to the mode indi¬ 
cated by vidjmode. 

Also notice that the routine waits until video blanking time to perform the op¬ 
eration and that video output is disabled on return. 

/$*$*****$* 

/* r_w_font() copies the indicated number of character fonts to or */ 
/* from the font ram starting at the indicated character */ 

/*************:i|c***********:4c*******:|e***********’t:*’)<’k>t'***>kH<***’l'**’|(*’k*’k:>|t**’i<:'f'/ 


void r_w_font(pfa, dir, c_value, count) /* read or write font ram */ 


register char *pfa; 
int dir; 

unsigned char c__value; 
register int count; 

{ 

int i; 

FONT far *pfnt; 

mode__init (2) ; 
outp(CTRL_REGB, 0x10); 
count <<= 4; /* 

pfnt = (FONT far *)VB8; 
pfnt += (unsigned int)c_value « 4 
if(dir) 

while(count—) 

(pfnt++)->font_byte = *pfa++; 

else 

while(count—) 

*pfa++ = (pfnt++)->font__byte; 
outp(CTRL_REGB, 0x00); 
mode_init(vid_mode); 


/* pointer to font array */ 
/* direction to move font data */ 
/* start at this char value */ 
/* number of character fonts */ 


/* loop counter */ 
/* pointer to access font ram */ 

/* text mode required */ 
/* enable font ram access */ 
16 bytes of data per char pattern */ 
/* initialize pointer to font ram */ 
/* offset to start of pattern */ 
/* nonzero means write font ram */ 
/* do requested count */ 
/* write to font ram */ 
/* zero means read font ram */ 
/* do requested count */ 
/* read font ram */ 
/* disable font ram access */ 
/* restore current video mode */ 
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The function mode_init places the video processor in a predefined mode state 
as indicated by the parameter d_mode. The video look-up table is initialized 
first because w_vlt() waits for blanking time to start its operation and the 
display is disabled when it returns. 

Because the CRT controller is in an unstable state during initialization, the 
video output must be disabled. 

The CRT controller has 18 internal registers, RO through R17. The last two, 
R16 and R17, are read only. Thus, they are ignored during initialization. The 
crt controller has two external registers, the index register and the data regis¬ 
ter. To access one of the 18 internal registers, write the desired register 
number to the index register and read or write the data register. 

The control register A and color select register are initialized to ensure that the 
contents are appropriate for the mode. 

Initializing control register B would enable the display. It was not done at this 
time to prevent flashing the display if other operations have to be performed. 
Other operations might include changing the font RAM, changing the video 
look-up table from the default or preparing the video memory. 

The function mvjcursor positions the cursor at the desired row and column 
location. 
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/* mode_init() initializes the crtc and mode registers by moving a */ 
/* table of values to the appropriate registers */ 

mode_init(d_mode) /* initialize to desired mode */ 


int d_mode; 

i 

register int i; 

register char *pc; 

MUTABLE *pmt; 
unsigned int intr_flag; 


/* desired video mode */ 

/* loop control */ 
/* pointer to crtc_table */ 
/* pointer to mode„table */ 
/* CPU IF state */ 


pmt = get_mode_p(d_mode); 
intr_flag = int_off(); 
w_vlt(pmt->vt, TRUE); 
pc = pmt->ct; 
for(i = 0; i < 16; i++) 

outp(CRTC_INDEX, i); 
outp(CRTC_DATA, *pc++); 

> 

outp(CTRL_REGA, pmt->cra); 
outp(COLR«SELC, pmt->csr); 
int_on(intr_flag); 


/* get pointer to video mode table */ 
/* no interrupts please */ 
/* write vlt data */ 
/* assign pointer to crtc_table */ 
/* do registers R0 through R15 */ 

/* indicate desired register */ 
/* write appropriate value */ 

/* set control register A */ 
/* set color select register */ 
/* allow interrupts */ 


/* mv_cursor() moves the cursor to the desired location */ 

mv_cursor(row, col) 


int row; 
int col; 

int i; 

register MUTABLE *pmt; 
unsigned int intr_flag; 

intr_flag = int_off(); 
pmt ■ get_mode_p(vid_mode); 
i = (pmt->width * row) + col; 
if (vid_mode ===== 0 I | vid_mode == 

outp(CRTC_INDEX, 14); 
outp(CRTC_DATA, i » 8); 
outp(CRTC_INDEX, 15); 


/* desired row */ 
/* desired column */ 


/* pointer to video mode table */ 
/* CPU IF state */ 

/* no interrupts please */ 
/* get pointer to video mode table */ 

1 || vid_mode == 2 || vid_mode == 3) 

/* indicate desired register */ 
/* write appropriate value */ 
/* indicate desired register */ 
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outp(CRTC.DATA, i k Oxff); 


/* write appropriate value */ 
/* allow interrupts */ 


> 

int_on(intr_flag); 

> 
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The function cursor_on positions the cursor and turns the cursor on, so that it 
is visible. 

The function cursor_off turns the cursor off, so that it is invisible. 


/* cursor_on() turns the cursor on */ 

cursor_on(row, col) 


int row; 
int col; 

{ 

unsigned int intr_flag; 

if(vid_mode == 0 || vid_mode == 1 

{ 

intr^flag = int_off(); 
mv_cursor(row, col); 
outp(CRTC_INDEX, 10); 
outp(CRTC_DATA, 0); 
outp(CRTC^INDEX, 11); 
outp(CRTC_DATA, fontji - 1); 
int_on(intr_flag); 

> 


/* desired row position */ 
/* desired column position */ 

/* CPU IF state */ 

I | vid_mode == 2 || vid_mode ** 3) 

/* no interrupts please */ 

/* indicate desired register */ 
/* write appropriate value */ 
/* indicate desired register */ 
/* write appropriate value */ 
/* allow interrupts */ 


> 


/* cursor_off() turns the cursor off */ 


eursor_off() 

{ 

unsigned int intr_flag; /* CPU IF state */ 


if(vid_mode == 0 || vid_mode == 1 I I vid.mode == 2 |I vid_mode == 3) 

{ 


intr_flag = int_off(); 
outp(CRTC_INDEX, 10); 
outp(CRTC_DATA, 17); 
int_on(intr_flag); 


/* no interrupts please */ 
/* indicate desired register */ 
/* write appropriate value */ 
/* allow interrupts */ 


> 
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The function setjnode establishes a new video mode. It does this by initializing 
the mode, clearing the screen (video memory) to an empty (blank) state, ena¬ 
bling the display and advertising the new mode in vid_mode. 

Notice that the video memory is cleared after the mode is initialized. This is 
because each mode enables only certain sections of video memory. 

The function screen on enables or disables the video output as indicated by the 
parameter flag. This is done through control register B. 


/* set_mode() sets the mode as indicated, clears the screen and */ 

/* sets the current video mode flag */ 

/^jlcHesk*********************^***************************^************^****/ 

set_mode(d_mode) /* set desired video mode */ 


int 

{ 

M_TABLE 


demode; 


*pmt; 


vidjmode = d_mode; 
pmt = get_mode_p(demode); 
mode_init(d_mode); 
clear_vid_mem(); 
screen_on(TRUE); 


/* desired mode */ 

/* pointer to mode_table */ 

/* tell world what new mode is */ 
/* get pointer to video mode table */ 
/* disable display 6 initialize mode */ 

/* clear screen */ 
/* enable the display */ 


/* screen_on() enables or disables the display (blanking / unblanking) */ 


8creen_on(flag) 


int 


flag; 


/* disable or enable display */ 
/* what to do */ 


register MUTABLE *pmt; 
if(flag) 

pmt = get_mode_p(vid_mode); 
outp(CTRL_REGB, pmt->crb); 

> 

else outp(CTRL_REGB, 0); 


/* pointer to video mode table */ 

/* nonzero means enable display */ 

/* get pointer to video mode table */ 
/* control reg B enables display */ 

/* all bits off will disable */ 
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The function clearjuidjnem initializes video memory to a value appropriate for 
the current mode. That is, in text modes the character byte is set to a space 
character and the attribute byte is set to medium intensity white foreground 
and a black background. For graphics modes, the color bits are set to zero 
(black). Only the addressable video memory is initialized. 

Notice that the pointer to video memory is declared as a pointer to an integer. 
The video memory data bus is a full 16-bit bus. Because text mode utilizes a 
character and attribute byte pair and graphics mode values are all zero, it is 
appropriate to take advantage of the 16-bit data bus. Also, the normal storage 
for an integer is low byte first and high byte second. 

The scan page size is specified in bytes. To calculate the correct memory size, 
the number of scan pages is multiplied by half of the scan page size. 


/* clear_vid_mem() based on the current mode, video memory is cleared */ 
/* to spaces or NULLs. The size of memory to clear */ 
/* is calculated from the mode table. */ 


clear_vid_mem() 

register unsigned int size; 
int far *pvm; 

MUTABLE *pmt; 

pmt = get_mode_p(vid_mode); 
pvm = (int far *)pmt->base; 
size = pmt->nsp * (pmt->sps » 1); 
switch(vid_mode) 

{ 

case 0: 
case 1: 
case 2: 
case 3: 

while(size—) *pvm++ = 0x0720; 
break; 

default: 

while(size—) *pvm++ = 0x0000; 
break; 

> 

> 


/* loop control */ 
/* pointer to video memory */ 
/* pointer to video mode table */ 

/* ptr to current mode data */ 
/* ptr to start of video mem */ 
/* number of integers to init */ 
/* text or graphics mode ? */ 

/* text modes initialized to */ 
/* a space character with */ 
/* medium intensity */ 

/* write char k attribute */ 

/* for graphics modes, just */ 
/* set all bits off */ 


Video Controller - Programming Example 7- 63 




The function dojborder displays the indicated character in a pattern or border 
(like a picture frame) at the extremes of the screen. It first decides whether the 
mode is a text mode or a graphics mode. For text mode, it retrieves the row 
and column counts from the mode table. Graphics mode programming is 
slightly more difficult. The row count is calculated by dividing the total scan 
lines by the fonts scan line height. The column count is calculated by dividing 
scan line width (measured in bytes) by the the number of color bits per pixel 
(only character fonts 8 pixels wide are supported in the example). 

It then executes a for loop to generate the pattern. After the pattern is 
displayed, a message is displayed describing the current video mode. Notice 
that in graphics mode, the font height is temporarily changed to display the 
message. This is because the message is displayed using an 8 x 16 character 
font and it must be accommodated when displaying the border in an 8 x 8 
character font. 


/* do_border() From the mode table, the maximum number of */ 

/* displayable lines is calculated and a border */ 

/* is drawn using the indicated character. */ 

do_border(pc) 
char *pc; 

unsigned char attr; 
char *pm; 

int row, rows; 

int col, cols; 

int t_font_h; 

MUTABLE *pmt; 


pmt = get_mode_p(vid_mode); 

/* 

pm = get_mess_p(vid_mode); 


switch(vid_mode) 

/* 

< 


case 0: 


case 1: 


case 2: 


case 3: 


attr = 0x07; /* black background k 

rows = pmt->length; 

/* 

cols = pmt->width; 

/* 


get pointer to mode table */ 
/* get pointer to message */ 
discover the current mode */ 

/* text mode 0 or */ 
/* text mode 1 or */ 
/* text mode 2 or */ 
/* text mode 3 ? */ 

medium intensity foregrnd */ 
length specified in table */ 
width specified in table */ 
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for(row = 0; row < rows; row++) 

i 


disp_t(row, 0, *pc, attr); 
if(row == 0 || row == rows - 1) 

for(col * 1; col < cols - 1; col++) 
disp_t(row, col, *pc, attr); 
disp_t(row, cols - 1, *pc, attr); 


/* write left side */ 
/* first or last row */ 


/* write right side */ 


col = (cols - strlen(pm)) » 1; /* center 

while(*pm) 

disp_t(rows » 1, col++, *pm++, attr); /* do 

pm = press; 

col = (cols - strlen(pm)) » 1; /* center 

while(*pm) 

disp_t((rows » 1) + 1, col++, *pm++, attr); /* do 
break; 


message */ 
message */ 
message */ 
message */ 


default: 

attr = Oxff » (8 - pmt->cb); 
rows = pmt->length / font_h; 
cols = pmt~>width / pmt->cb; 
for(row = 0; row < rows; row++) 
< 


/* medium intensity */ 
/* rows for this font */ 
/* columns this mode */ 
/* do all rows */ 


disp_t(row, 0, *pc, attr); /* write left side */ 

if(row “ 0 || row == rows - 1) 

for(col = 1; col < cols - 1; col++) 
disp_t(row, col, *pc, attr); 

disp_t(row, cols - 1, *pc, attr); /* write right side */ 

>; 

t_font_h = font_h; 
font_h = 16; 

col = (cols - strlen(pm)) » 1; 
while(*pm) 

disp.t(pmt->length » B, col++, *pm++, attr); /* do message */ 
pm = press; 

col = (cols - strlen(pm)) » 1; /* center message */ 

while(*pm) 

disp_t((rows » 1) +1, col++, *pm++, attr); /* do message */ 
font__h = t_font_h; /* restore current font */ 

break; 


/* save current font */ 
/* message font is 8 x 16 */ 
/* center message */ 
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The function disp_g displays a character at the desired row and column loca¬ 
tion. The color bit pixels that form the character are set to value in attr. The 
routine assumes that it is provided an attribute that is consistent with the 
number of color bits per pixel. 

The routine calculates the position as a constant offset to the first byte of the 
first scan line. After the scan line has been displayed, the scan line offset is 
incremented to the next scan page. After writing a scan line to each scan page, 
the scan line offset is zeroed and the constant offset is incremented by the 
length of one scan line. The actual position is the constant offset plus the scan 
line offset. 

The middle for loop ensures that all eight pixels of the scan line are displayed. 
For example, a 16-color display requires four color bits per pixel or four bytes 
per character scan line. 

For each pixel, the interior for loop shifts the color bit image and if the pixel 
bit is set, the color bit attribute is OBed into the color bit image. The number 
of pixel representations per byte is determined by dividing the font width by 
the number of color bits per pixel. Only eight pixel wide fonts are supported by 
the example. 
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/*****************************************************♦*****************/ 

/* disp_g() Draws a character in graphics mode at the calculated */ 
/* row and column position. */ 

j sjc * * He **** * *3fc ******** * **** jje :+:* * * * * * * ****** * *** 9|c * 9(C s)c 9(c 9|e sfc 3|e s(c sf: 3fc sfe 3)e Sic ********** * ** * j 

disp__g(row, col, pc, attr) 


int row, col; 

register unsigned char *pc; 
unsigned char attr; 

{ 

unsigned char far *pvm; 
unsigned char bi; 
unsigned char bd; 
int be; 
int tbc; 
int scan; 
long c_off; 
unsigned int s_off; 
register MUTABLE *pmt; 


/* pointer to video memory */ 
/* bit image */ 
/* for bit testing */ 
/* bit count (current) */ 
/* terminating bit count */ 
/* current scan line */ 
/* character offset */ 
/* scan line offset */ 
/* mode data */ 


> 


pmt = get_mode_p(vid_mode); /* get pointer to mode table */ 

c_off = pmt->base + (col * pmt->cb) + /* address of first byte */ 

(row * pmt->width * (font_h / pmt->nsp)); 
tbc = font_w / pmt->cb; /* bit image bit count per byte */ 

s_off =0; /* scan line offset */ 

for(scan = 0; scan < fontjh; scan++, pc++) /* do all scan lines */ 


if(scan && scan % pmt->nsp 

i 

c_off += pmt->width; 
s_off = 0; 

> 

pvm = (char far *)(c_off + 
s_off += pmt->sps; /* 

for(bd « 0x80; bd;) 

{ 


== 0) /* done all scan pages ? */ 

/* offset by one scan line */ 
/* reset to first scan page */ 

s_off); /* ptr to first byte of scan */ 

offset to next scan page, for next pass */ 
/* start at left most bit/pixel */ 


bi = 0x00; /* null bit image */ 

for (be = 0; be < tbc; bc++, bd »= 1) /* do a byte of scan */ 


bi <<= pmt->cb; /* shift bit image by # of color bits */ 

if(*pc & bd) bi |= attr; /* or in next bit image */ 

> 

*pvm++ = bi; /* write a byte of scan line */ 

> 

> 
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The function dispj displays a character and attribute at the desired row and 
column location. 

The example uses zero-based row and column values. When calculating the po¬ 
sition, this saves subtracting one from the row and column values. 

Notice that the pointer to video memory is declared as a pointer to an integer. 
The video memory data bus is a full 16-bit bus. Because text mode utilizes a 
character and attribute byte pair, it is appropriate to take advantage of the 
16-bit data bus. Also, the normal storage for an integer is low byte first and 
high byte second. 

/$*****$$**$*$$$$*&**$*$*********$**# 

/* disp_t() writes a character and its attribute to the indicated */ 
/* row and column position */ 

/$**********$$**$$*******$****:**$**$************ 


disp_t(row, col, c, attr) 

int row; 

int col; 

unsigned char c; 
unsigned char attr; 

{ 

int far *pvm; /* pointer to video memory */ 

register MUTABLE *pmt; 

if(vid_mode == 0 | vid.mode == 1 | vid.mode == 2 | vid_mode =- 3) 

{ 

pmt = get_mode_p(vid_mode); /* get pointer to mode table */ 

/* get address of character */ 

pvm = (int far *)(pmt->base + 

(row * (pmt->width « 1) + (col << 1))); 

*pvm = ((int)attr « 8) | (int)c; /* character & attribute */ 

> 

else disp_g(row, col, &c_font[c][0], attr); 
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The function video sets up various conditions and executes the example pro¬ 
gram. The major points are: 

1. Read the current font and save it. 

2. Select a video mode. 

3. Change the pattern of the letter *E’ to a mirror image of the letter ‘E.’ 

4. Restore the pattern of the letter ‘E’ from the saved font. 

5. Display the letter *E’ border pattern in the selected video mode. 

6. Restore the video mode to mode 3 and exit. 

/* video() - execute video examples */ 

/*****♦**♦♦*♦****♦*****♦♦♦♦♦♦*♦♦*♦♦♦♦♦♦*♦**♦*♦*♦****♦***♦♦***♦****♦*****/ 

video() 

{ 

static MESSAGE mvid[] = /* video menu */ 


{ 

3, 

33, 

"Video Example" >, 

{ 

5, 

24, 

"FI. 

Select video mode" >, 

{ 

6, 

24, 

"F2. 

Invert letter E" >, 

{ 

7, 

24, 

"F3. 

Restore letter E" >, 

i 

8. 

24, 

"F4. 

Display selected video mode" } 

i 

9, 

24, 

"F10. 

Return to Main menu" }, 

i 

0. 

0, 

0 >, 



>; 

static MESSAGE mvmd[] = /* video menu */ 


< 

3, 

31. 

"Select Video Mode" >, 


•c 

6, 

24, 

"FI. 

40 x 26 Text" >, 


< 

6, 

24. 

"F2. 

80 x 26 Text" >, 



7, 

24, 

"F3. 

320 x 200 

x 4-color" 

>, 

< 

8. 

24, 

"F4. 

320 x 200 

x 16-color 

" >. 

< 

9, 

24, 

"F5. 

640 x 200 

x 2-color" 

>, 

< 

10, 

24, 

"F6. 

640 x 200 

x 4-color" 

>, 

■c 

11. 

24, 

"F7. 

640 x 400 

x 2-color" 

>. 

< 

12, 

24, 

"F8. 

640 x 400 

x 4-color" 

>. 

< 

13, 

24. 

"F9. 

800 x 252 

x 4-color" 

>. 

* 

14, 

24, 

"F10. 

Return to 

video example" 

< 

0, 

0. 

0 >, 





>; 


char line[512]; 


/♦to hold input line */ 
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int i; 
int mode; 
unsigned char c; 


/* to hold menu selection */ 
/* temp value for mode */ 


r_w_font(&c_font[0][0], FALSE, 0x00, 

set_mode(3); 

disp_menu(mvid); 

line[0] = 0; 

while(1) 

switch(line[0]) 
case FI: 

disp__menu(mvmd); 
line[0] = get_fkey(); 
switch(line[0]) 


case 

FI 

mode 

= 1; break; 

case 

F2 

mode 

= 3; break; 

case 

F3 

mode 

= 4; break; 

case 

F4 

mode 

= Oxfe; break; 

case 

F5 

mode 

= 6; break; 

case 

F6 

mode 

= Oxff; break; 

case 

F7 

mode 

= OxdO; break; 

case 

F8 

mode 

= Oxdl; break; 

case 

F9 

mode 

= 0xd2; break; 

case 

F10: break; 

> 




break; 




case F2: 





r_w_font(&rltr_e[0] , TRUE, ’E\ 

set_mode(3); 

break; 

case F3: 

r_w_font(&c_font[*E*][0], TRUE, 

set_mode(3); 

break; 


256); /* read all font ram */ 

/* reset video mode */ 
/* display the video menu */ 
/* null terminated */ 
/* forever (see F10) */ 

/* determine menu selection */ 

/* select video mode */ 
/* display the mode menu */ 
/* get a function key selection */ 


/* reverse 'E* to font ram */ 

1); 

/* reset video mode */ 


/* restore *E* to font ram */ 
’E\ 1); 

/* reset video mode */ 


case F4: /* display selected mode */ 

set_mode(mode); /* set the desired mode */ 

do_border( ff E”) ; /* write letter 'E* at screen extremes */ 

while(1) if (get_key(Ac) >** 0 kk c " 0) break; 
while(1) if(get__key(&c) >■ 0) break; 

set_mode(3); /* set the desired mode */ 

break; 
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case F10: 
return; 


/* return to caller (main menu) */ 


> 

disp_menu(mvid); /* display the rtc menu */ 

line[0] = get_fkey(); /* get a function key for menu selection */ 
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Chapter 8 

Keyboard-Interface Controller 

and Keyboard 


Introduction 

The keyboard-interface controller is an Intel 8042 microcomputer with internal 
firmware developed by DIGITAL. The keyboard-interface controller provides a 
physical and logical interface between the LK250 keyboard and the VAXmate 
CPU. Also, it provides several hardware control functions that are unrelated to 
the LK250 keyboard. 

The LK250 keyboard is an intelligent keyboard with 105 keys. The keys are 
divided into functional groups as follows: 


• 57 key main section 

• 20 key function-key section 

• 18 key keypad section 

• 10 key auxiliary and direction key section 


Keyboard-Interface Controller 

Physical Interface to the CPU 

The VAXmate CPU communicates with the keyboard-interface controller 
through two 8-bit parallel ports in input/output (I/O) address space 0060H and 
0064H. The registers accessed through these ports are: 


• Reading port 0064H accesses the status register. 

• Writing port 0064H accesses the command register. 

• Reading port 0060H accesses the output data register. 

• Writing port 0060H accesses the input data register. 


The contents and usage of these registers are described later in this chapter. 
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Physical Interface to the Keyboard 

The keyboard-interface controller communicates with the LK250 keyboard over 
a bi-directional serial data line. A second line provides serial clock rate. A com¬ 
bination of signals and timing on the serial clock line provides the communica¬ 
tions protocol. These lines are in the coiled cable that connects the LK250 
keyboard and the VAXmate workstation. 

Logical Interface 

The keyboard-interface controller has two modes of operation, pass-through or 
translate. In pass-through mode, all data received from the LK250 keyboard 
are stored in the output buffer without modification. In translate mode, all data 
in the range 00H-99H and FOH are translated to an industry-standard or a 
DIGITAL extended scan code and stored in the output buffer. Bit 6 of the 
command byte controls this mode of operation. The keyboard-interface control¬ 
lers default mode is pass through. 

NOTE 

During the system powerup initialization, the ROM BIOS sets 
the keyboard-interface controller to translate mode. Therefore, 
the operating system sees the keyboard-interface controller in 
translate mode. 
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Control Functions 

The keyboard-interface controller performs some control and status functions 
that are unrelated to LK250 keyboard operation. Therefore, the keyboard- 
interface controller has two 8-bit ports, port 1 and port 2, that are in the 
keyboard-interface controller I/O address space. Commands are available that 
instruct the keyboard-interface controller to read port 1 and read or write port 
2. Those commands are discussed in the command register section. Table 8-1 
defines the port 1 bits and Table 8-2 defines the port 2 bits. 


Table 8-1 Port 1 Bit Definitions 


Bit 

Description 

7 

Undefined 

6 

Always 0 

5-3 

Undefined 

2 

EXPANSION BOX INSTALLED 

0 = Expansion box installed 

1 = Expansion box not installed 

1 

RAM OPTION INSTALLED 

0 = RAM option installed 

1 = RAM option not installed 

0 

RAM OPTION ERROR 

0 = RAM option parity error 

1 = No error 
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Table 8-2 Port 2 Bit Definitions 


Bit Description 


7 Keyboard data (output) 

6 Keyboard clock inverted (output) 

5 Undefined 

4 CPU IRQ1 

0 = Keyboard-interface controller not interrupting 
1 = Keyboard-interface controller interrupt to CPU 

3 Undefined 

2 Undefined 

1 Gate system address line 20 

0 = System address line 20 enabled. Use this state for 80286 vir¬ 
tual protected mode. 

1 = System address line 20 disabled. Use this state for 80286 real 
mode. 

0 Reset 80286 CPU (affects only the CPU) 

0 = 80286 CPU in reset state 

1 = 80286 CPU not in reset state 


Keyboard-Interface Controller Diagnostics 

On powerup, the keyboard-interface controller executes a diagnostic test. The 
test verifies the keyboard-interface controllers ROM and RAM. The keyboard- 
interface controller completes the test within 200 ms after powerup. During the 
powerup test, the LK250 keyboard is ignored. 

Failing this test is considered a fatal system error. If an error occurs during 
powerup testing, the keyboard-interface controller will not respond to any input, 
and must be reset. To reset the keyboard-interface controller, turn the 
VAXmate workstation off and then on. 
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Keyboard-Interface Controller Registers 

Data Register (0060H) 

76543210 

- 1 - 1 - 1 - 1 - 1 - 1 - 1 - 

DATA 

_I_I_I_I_I_I_I_ 

Bit R/W Description 

7-0 R/W The CPU reads or writes this port to exchange data with the 
keyboard-interface controller 

Command Register (0064H) 

76543210 
- 1 - 1 - 1 - 1 - 1 - 1 - 1 - 

STATUS OR COMMAND REGISTER 

_I_I_I_I_I_I_I_ 

Bit R/W Description 

7-0 R The CPU reads the keyboard-interface controller status register 

W The CPU writes the keyboard-interface controller command 
register 


Keyboard-Interface Controller - Hardware Description 8-5 












Status Register (0064H) 


76543210 


PARITY 

RECEIVE 

XMIT 

KEYBRD 

COMMAND 

SYSTEM 

INPUT 

OUTPUT 

ERROR 

TIME¬ 

TIME¬ 

INHIBIT 

/DATA 

FLAG 

BUFFER 

BUFFER 


OUT 

OUT 

SWITCH 



FULL 

FULL 


Bit R/W Description 

7 R PARITY ERROR 

0 = No parity error 
1 = Parity error 

The keyboard to keyboard-interface controller serial communica¬ 
tions use odd parity checking. When data from the keyboard con¬ 
tains a parity error, this bit is set to 1. Reading the status register 
clears this bit. 

6 R RECEIVE TIMEOUT 

0 = No receive timeout error 

1 = An in-progress transmission from the keyboard was not com¬ 
pleted within 2 ms. 

Reading the status register clears this bit. 

5 R XMIT TIMEOUT - Transmit Timeout 

0 = No transmit timeout error 

1 = An in-progress transmission from the keyboard-interface con¬ 
troller to the keyboard was not completed within 2 ms. 

Reading the status register clears this bit. 

This bit is also used in combination with the parity error bit or the 
receive timeout bit to establish additional error conditions as 
follows: 

• If the transmission to the keyboard completes within 2 ms, but 
the response from the keyboard is not received within 20 ms, 
then the transmit and receive timeout bits are set to 1. 

• If the transmission to the keyboard and the response from the 
keyboard complete within the designated time frame, but the 
response contains a parity error, then the transmit timeout 
and parity error bits are set to 1. 
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Bit R/W Description (Status Register - cont.) 


4 R KEYBRD INHIBIT SWITCH - Keyboard Inhibit Switch 
0 = Keyboard is inhibited (locked) 

1 = Keyboard is active (unlocked) 

The VAXmate workstation does not have a keyboard lock, so this 
bit is always set to 1. 

3 R COMMAND/DATA 

0 = Of the pair (0060H/0064H), the last I/O write was to the 
data register, at I/O address 0060H. 

1 = Of the pair (0060H/0064H), the last I/O write was to the 
command register, at I/O address 0064H. 

This bit is used internally by the keyboard-interface controller. It 
determines whether the byte in the keyboard-interface controllers 
input buffer is a command or data. 

2 R SYSTEM FLAG 

0 = ROM BIOS should execute a normal powerup initialization 
process 

1 = A virtual protected mode task request to reset the CPU to 
real mode 

The ROM BIOS interprets the state of the system flag to deter¬ 
mine the reason the VAXmate CPU reset pin was toggled. If the 
system flag is set, the VAXmate CPU is returning to real mode 
from virtual protected mode. Otherwise, the ROM BIOS executes 
a normal powerup initialization process. 

During the keyboard-interface controllers powerup initialization se¬ 
quence, the keyboard-interface controller clears the system flag to 
0 . 

Setting or clearing the system flag is a two step process: Issue a 
write-command-byte instruction by writing the value 0060H to the 
command register at I/O address 0064H. The write-command-byte 
instruction is discussed in detail later in this chapter. 

Write the command byte to the input data register at I/O address 
0060H. The system flag reflects the value of bit 2 of the command 
byte. If bit 2 of the command byte is set to 1, so is the system 
flag. When bit 2 is 0, the system flag is cleared to 0. 


Keyboard-Interface Controller - Hardware Description 


8- 7 



Bit R/W Description (Status Register - cont.) 


1 


0 


R INPUT BUFFER FULL 

0 = Keyboard-interface controller input data buffer is empty 
1 = Keyboard-interface controller input data buffer contains data 
that has not been processed by the keyboard-interface 
controller. 

Data written to the input data register is transferred to the 
keyboard-interface controllers input data buffer. This bit reflects 
the status of the input data buffer. 

R OUTPUT BUFFER FULL 

0 = Keyboard-interface controller output data buffer is empty 
1 = Keyboard-interface controller output data buffer contains 
data that the CPU has not read 


The status register is an 8-bit read-only register at I/O address 0064H. 

It contains information about the keyboard-interface controller and keyboard. 
Status changes do not cause an interrupt. The status register can be read at 
any time. 

The keyboard-interface controller command E1H allows the CPU to initialize 
bits 7-4 of the status register. See the keyboard-interface controller command 
register description. 
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Command Register (0064H) 


76543210 
- 1 -,- ( -,-,-,-,- 

COMMAND DATA 

_I_I_I_I_I_I_I_ 


Bit Description 

7-0 Keyboard-interface controller commands from the CPU 


The data written to this register are instructions to the keyboard-interface con¬ 
troller. Table 8-3 lists the keyboard-interface controller commands. 


Table 8-3 Keyboard-Interface Controller Commands 


Command 

Value 

Description 

Command 

Value 

Description 

00H-1FH 

Reserved 

COH 

Read Port 1 

20H 

Read command byte 

C1H 

Read Port 1 

21H-5FH 

Reserved 

C2H-CFH 

Reserved 

60H 

Write command byte 

DOH 

Read Port 2 

61H-A9H 

Reserved 

D1H 

Write Port 2 

AAH 

Self-test 

D2H-DFH 

Reserved 

ABH 

Interface test 

EOH 

Read test inputs 

ACH 

Reserved for expansion 

E1H 

Write status 
register 

ADH 

Disable keyboard 

E2H-EFH 

Reserved 

AEH 

Enable keyboard 

FOH-FFH 

Pulse output port 

AFH-BFH 

Reserved 
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Read Command Byte (20H) 

Write Command Byte (60H) 

The keyboard-interface controller has an internally stored command byte that 
determines how the interface controller responds to various conditions. The two 
commands, read command byte and write command byte, provide access to 
that command byte. When the keyboard-interface controller receives a read- 
command-byte command, it places the internally stored command byte in the 
output buffer. When the keyboard-interface controller receives a write- 
command-byte command, it stores the next data byte, written to the input data 
register at I/O address 0060H, to the internally stored command byte. Table 
8-4 defines the command byte bits. 

Table 8-4 Command Byte Bit Definitions 

Bit R/W Definition 


7 

6 


5 

4 


3 


R/W Always 0 

R/W Scan Code Type 

0 = The LK250 scan codes are passed through without conver¬ 
sion (pass-through mode). 

1 = The keyboard-interface controller converts the LK250 key¬ 
board scan codes to industry-standard one byte values 
(translate mode). 

R/W Interface Type - Always 0 

R/W Disable Keyboard 

0 = Keyboard enabled 

1 = Keyboard disabled 

The keyboard-interface controller disables the keyboard by setting 
the clock line to a low state. This bit is cleared by writing this 
command byte or by writing LK250 keyboard data to the input 
data register at I/O address 0060H. 

R/W Inhibit Override 

0 = Keyboard inhibit switch enabled (see status register bit 4). 

1 = Keyboard inhibit switch disabled and the key lock function is 

overridden (see status register bit 4). 
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Table 8-4 Command Byte Bit Definitions (cont.) 


Bit R/W Definition 


2 


1 

0 


R/W System Flag 

0 = ROM BIOS should execute a normal powerup initialization 
process 

1 = A virtual protected mode task request to reset the CPU to 
real mode 

The ROM BIOS interprets the state of the system flag to deter¬ 
mine the reason the VAXmate CPU reset pin was toggled. If the 
system flag is set, the VAXmate CPU is returning to real mode 
from virtual protected mode. Otherwise, the ROM BIOS executes 
a normal powerup initialization process. 

During the keyboard-interface controllers powerup initialization se¬ 
quence, the keyboard-interface controller clears the system flag to 
zero. 

See the status register bit 2 description. 

R/W Always 0 

R/W Enable Output-Buffer-Full Interrupt 

0 = Keyboard-interface controller does not generate interrupts to 
the CPU 

1 = When the keyboard-interface controller places data in the 
output buffer, the keyboard-interface controller generates an 
interrupt to the VAXmate CPU. 


Keyboard-Interface Controller - Hardware Description 


8 - 11 






Self-Test (AAH) 

This command causes the keyboard-interface controller to perform internal 
diagnostic tests. The command byte is reset to 10H (keyboard disabled) and 
interrupts to the VAXmate CPU are disabled. The system flag (status register 
bit 2) is not changed. One of three possible diagnostic result codes is placed in 
the output buffer. 


Diagnostic Code Meaning 


55H 

No errors detected 

FEH 

Invalid ROM checksum 

FDH 

RAM test failed 

Interface Test (ABH) 


This command causes the keyboard-interface controller to test the state of the 
LK250 keyboard-interface lines. One of five possible diagnostic result codes is 

placed in the output buffer. 


Diagnostic Code 

Meaning 

00H 

No errors detected 

01H 

LK250 keyboard clock line always low 

02H 

LK250 keyboard clock line always high 

03H 

LK250 keyboard data line always low 

04H 

LK250 keyboard data line always high 


Disable Keyboard (ADH) 

This command sets bit 4 of the keyboard-interface controller command byte. 
The keyboard-interface controller disables the keyboard-interface by setting the 
clock line low. 

Enable Keyboard (AEH) 

This command clears bit 4 of the keyboard-interface controller command byte. 
The keyboard-interface controller enables the keyboard interface by freeing the 
clock line. 

Read Port 1 (COH) 

The keyboard-interface controller reads port 1 (bits 7-0), sets bits 3-0 to 1 (for 
compatibility), and places the result in the output buffer. For port 1 bit 
definitions, see Table 8-1. Because it overwrites any data in the buffer, this 
command should not be used unless the output buffer is empty. 

Read Port 1 (C1H) 

The keyboard-interface controller reads port 1 (bits 7-0) and places bits 7-0 
(without modification) in the output buffer. For port 1 bit definitions, see 
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Table 8-1. Because it overwrites any data in the buffer, this command should 
not be used unless the output buffer is empty. 

Read Port 2 (DOH) 

The keyboard-interface controller reads port 2 (bits 7-0) and places bits 7-0 in 
the output buffer. For port 2 bit definitions, see Table 8-2. Because it over¬ 
writes any data in the buffer, this command should not be used unless the 
output buffer is empty. 

Write Port 2 (D1H) 

The keyboard-interface controller takes the next byte of data written to the 
input data register at I/O address 0060H and writes it to the keyboard- 
interface controller output port 2. For port 2 bit definitions, see Table 8-2. 

CAUTION 

Bit 0 of keyboard-interface controller output port 2 is connected 
to the VAXmate CPU reset circuitry. Clearing bit 0 to a zero 
places the VAXmate CPU in a permanent reset state. 

Read Test Inputs (EOH) 

The keyboard-interface controller reads its TO and T1 inputs and places the 
data in the output buffer. This command writes over any data in the output 
buffer that has not been read by the CPU. Bit 0 corresponds to the state of TO 
and bit 1 corresponds to the state of Tl. 

Write Status Register (E1H) 

This is a diagnostic command. The keyboard-interface controller takes bits 7-4 
of the next byte written to the input data register (60H) and writes them to 
bits 7-4 of the status register. Only bits 7-4 are affected. 

After the next keyboard-interface controller command that makes data avail¬ 
able to the VAXmate CPU, the keyboard-interface controller updates the status 
register to reflect the current status. 

Pulse Output Port (FOH-FFH) 

The keyboard-interface controller pulses bits 3-0 of port 2 according to the 
value of bits 3-0 of the command value. Any of the bits 3-0 that are clear in 
the command byte are pulsed low for approximately six microseconds. 

All four bits (3-0) are affected by this command, but bits 3-2 are not connected 
to anything. Bit 1 gates the address line A20. Bit 0 is connected to the 
VAXmate CPU reset circuitry. The ROM BIOS uses this command to return 
to real mode from virtual protected mode. 
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Keyboard-Interface Controller Error Handling 

If the LK250 keyboard initiates a transmission sequence and the data is re¬ 
ceived with a parity error, the keyboard-interface controller issues a resend 
command. If the response to the resend command is bad, the keyboard- 
interface controller places an FFH code in the output buffer and sets the parity 
error bit in the status register. 

If the keyboard-interface controller cannot start a transmission within 15 milli¬ 
seconds or it cannot complete a transmission within two milliseconds after it 
was started, the transmit timeout bit is set in the status register and an FEH 
(keyboard resend request) is placed in the output buffer. 

If the LK250 keyboard does not respond within 20 milliseconds, then the 
transmit timeout bit and receive timeout bit are set in the status register. If 
the LK250 keyboard response was received with a parity error, then the 
transmit timeout bit and the parity error bit are set in the status register and 
an FEH (keyboard resend request) is placed in the output buffer. 

If the keyboard-interface controller has not inhibited the keyboard and a LK250 
keyboard transmission does not complete within two milliseconds after it is 
started, the receive timeout bit is set in the status register. A resend command 
is not issued by the keyboard-interface controller. 
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LK250 Keyboard 

Scan Codes 

When a key is pressed, the LK250 keyboard transmits a value, in the range 
01H-99H, that identifies the pressed key. This value is known as a scan code. 
If the key is held down for a time that exceeds the autorepeat delay time, the 
keyboard repeatedly transmits the scan code at the autorepeat rate. When a 
key is released, the LK250 keyboard transmits a release code of FOH followed 
by the scan code of the released key. 

The LK250 keyboard transmits scan codes to the keyboard-interface controller. 
If the keyboard-interface controller is in pass-through mode, the keyboard- 
interface controller transmits the scan code or release code (FOH) and scan 
code without conversion. If the keyboard-interface controller is in translate 
mode, the keyboard-interface controller converts the LK250 scan code or re¬ 
lease code (FOH) and scan code to an industry-standard 1-byte value. In the 
industry-standard representation, a released key is indicated by adding 80H to 
the translated scan code value. 

Table 8-5 lists the LK250 scan codes, their equivalent keyboard-interface- 
controller translated industry-standard value, and keyboard location label. 
Figure 8-1, a representation of the LK250 keyboard, shows location labels for 
each key position. 

Table 8-6 lists values in the scan code range (01H-99H) that the LK250 key¬ 
board does not use to represent keys. However, in translate mode, the 
keyboard-interface controller translates them to the indicated industry-standard 
value. 
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Table 8-5 

LK250 Scan Codes and Industry-Standard Equivalent Value 


Translated 
Industry-Standard 
Scan Code 

Keyboard 

Position 

Key Name 

01H 

43H 

G08 

F9 

03H 

3FH 

G03 

F5 

04H 

3DH 

G01 

F3 

05H 

3BH 

G99 

FI 

06H 

3CH 

GOO 

F2 

09H 

44H 

G09 

F10 

OAH 

42H 

G07 

F8 

OBH 

40H 

G05 

F6 

OCH 

3EH 

G02 

F4 

ODH 

OFH 

D00 

Tab 

OEH 

29H 

BOO 

< ~ 

11H 

38H 

A99 

Alt 

12H 

2AH 

B99 

Left Shift 

14H 

1DH 

C99 

Ctrl 

15H 

10H 

D01 

q Q 

16H 

02H 

E01 

1 ! 

1AH 

2CH 

B01 

z Z 

1BH 

1FH 

C01 

s S 

1CH 

1EH 

C01 

a A 

1DH 

11H 

D02 

w W 

1EH 

03H 

E02 

2 @ 

21H 

2EH 

B03 

c C 

22H 

2DH 

B02 

x X 

23H 

20H 

C03 

d D 

24H 

12H 

D03 

e E 

25H 

05H 

E04 

4 $ 

26H 

04H 

E03 

3 # 

29H 

39H 

A01 

Space Bar 

2AH 

2FH 

B04 

v V 

2BH 

21H 

C04 

f F 

2CH 

14H 

D05 

t T 
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Table 8-5 LK250 Scan Codes and Industry-Standard Equivalent Value (cont.) 


LK250 

Scan 

Code 

Translated 
Industry-Standard 
Scan Code 

Keyboard 

Position 

Key Name 

2DH 

13H 

D04 

r R 

2EH 

06H 

E05 

5 % 

31H 

31H 

B06 

n N 

32H 

30H 

B05 

b B 

33H 

23H 

C06 

h H 

34H 

22H 

C05 

g G 

35H 

15H 

D06 

y y 

36H 

07H 

E06 

6 A 

3AH 

32H 

B07 

m M 

3BH 

24H 

C07 

j J 

3CH 

16H 

D07 

u U 

3DH 

08H 

E07 

7 & 

3EH 

09H 

E08 

8 * 

41H 

33H 

B08 


42H 

25H 

C08 

k K 

43H 

17H 

D08 

i I 

44H 

18H 

D09 

o O (Letter) 

45H 

OBH 

E10 

0 ) 

46H 

OAH 

E09 

9 ( 

49H 

34H 

B09 

. > 

4AH 

35H 

BIO 

/ ? 

4BH 

26H 

C09 

1 L 

4CH 

27H 

CIO 

5 • 

4DH 

19H 

DIO 

PP 

4EH 

OCH 

Ell 

_ 

52H 

28H 

Cll 

» IT 

54H 

1AH 

Dll 

[ { 

55H 

ODH 

E12 

= + 

58H 

3AH 

COO 

Lock 

59H 

36H 

Bll 

Right Shift 

5AH 

1CH 

C13 

Return 

5BH 

1BH 

D12 

] } 
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Table 8-5 LK250 Scan Codes and Industry-Standard Equivalent Value (cont.) 


LK250 

Scan 

Code 

Translated 
Industry-Standard 
Scan Code 

Keyboard 

Position 

Key Name 

5DH 

2BH 

E12 

\ 1 

66H 

OEH 

E13 

Delete (Word/Char) 

69H 

4FH 

B20 

1 End 

6BH 

4BH 

C20 

4 Left-Arrow 

6CH 

47H 

D20 

7 Home 

70H 

52H 

A20 

0 Ins 

71H 

53H 

A22 

. Del 

72H 

50H 

B21 

2 Down-Arrow 

73H 

4CH 

C21 

5 

74H 

4DH 

C22 

6 Right-Arrow 

75H 

48H 

D21 

8 Up-Arrow 

76H 

01H 

E20 

Esc 

77H 

45H 

E21 

NumLock 

79H 

4EH 

C23 

+ (Keypad) 

7AH 

51H 

B22 

3 PgDn 

7BH 

4AH 

D23 

- (Keypad) 

7CH 

37H 

E23 

PrtSc * 

7DH 

49H 

D22 

9 PgUp 

7EH 

46H 

E22 

ScrlLock Break 

7FH 

54H 


SysReq (Alt/F20) 

83H 

41H 

G06 

F7 

84H 

54H 

G23 

F20 

85H 

55H 

E16 

Find 

86H 

56H 

E17 

Insert Here 

87H 

57H 

E18 

Remove 

88H 

58H 

D16 

Select 

89H 

59H 

D17 

Prev 

8AH 

5AH 

D18 

Next 

8BH 

5BH 

C17 

Up-Arrow 

8CH 

5CH 

B16 

Left-Arrow 

8DH 

5DH 

B17 

Down-Arrow 

8EH 

5EH 

B18 

Right-Arrow 
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Table 8-5 LK250 Scan Codes and Industry-Standard Equivalent Value (cont.) 


LK250 

Scan 

Code 

Translated 
Industry-Standard 
Scan Code 

Keyboard 

Position 

Key Name 

8FH 

5FH 

Gil 

Fll 

90H 

60H 

G12 

F12 

91H 

61H 

G13 

F13 

92H 

62H 

G14 

F14 

93H 

63H 

G15 

Help 

94H 

64H 

G16 

Do 

95H 

65H 

G20 

F17 

96H 

66H 

G21 

F18 

97H 

67H 

G22 

F19 

98H 

68H 

E00 

Compose 

99H 

69H 

A23 

Enter (Keypad) 
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Table 8-6 Scan Codes Translated But Not Used 


Unused 

Scan 

Code 

Translated 

Industry-Standard 

Scan Code 

Unused 

Scan 

Code 

Translated 
Industry-Standard 
Scan Code 

02H 

41H 

51H 

73H 

07 H 

58H 

53H 

74H 

08H 

64H 

56H 

62H 

OFH 

59H 

57H 

6EH 

10H 

65H 

5CH 

75H 

13H 

70H 

5EH 

63H 

17H 

5AH 

5FH 

76H 

18H 

66H 

60H 

55H 

19H 

71H 

61H 

56H 

1FH 

5BH 

62H 

77H 

20H 

67H 

63 H 

78H 

27H 

5CH 

64H 

79H 

28H 

68H 

65H 

7AH 

2FH 

5DH 

67H 

7BH 

30H 

69H 

68H 

7CH 

37H 

5EH 

6AH 

7DH 

38H 

6AH 

6DH 

7EH 

39H 

72H 

6EH 

7FH 

3FH 

5FH 

6FH 

6FH 

40H 

6BH 

78H 

57H 

47H 

60H 

80H 

80H 

48H 

6CH 

81H 

81H 

4FH 

50H 

61H 

6DH 

82H 

82H 
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LK250 Keyboard Command Codes 

Table 8-7 provides a summary of the LK250 command codes. Following Table 
8-7 are descriptions of each command. The command descriptions give the pur¬ 
pose of the command, the actions taken by the keyboard, and the response 
code transmitted by the LK250 keyboard. The LK250 keyboard response codes 
are described later in this chapter. 


Table 8-7 LK250 Keyboard Command Codes 


Value 

Description 

OOH-AAH 

Invalid Commands 

ABH 

Request Keyboard ID (Digital Extended) 

ACH 

Enter Digital Extended Scan Code Mode 

ADH 

Exit Digital Extended Scan Code Mode 

AEH 

Set Keyboard LED (Digital Extended) 

AFH 

Reset Keyboard LED (Digital Extended) 

BOH 

Set Keyclick Volume (Digital Extended) 

B1H 

Enable Autorepeat 

B2H 

Disable Autorepeat 

B3H 

Keyboard Mode Lock 

B4H 

Keyboard Mode Unlock 

B5H-ECH 

Reserved 

EDH 

LEDs On/Off 

EEH 

Echo 

EFH-F2H 

Reserved 

F3H 

Set Autorepeat Delay and Rate 

F4H 

Enable Key Scanning 

F5H 

Disable Key Scanning and Restore to Defaults 

F6H 

Restore To Defaults 

F7H-FDH 

Reserved 

FEH 

Resend 

FFH 

Reset 
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Invalid Commands (OOH-AAH) 

Industry-Standard 


When the LK250 keyboard receives a code in the range OOH-AAH, it transmits 
a resend request. The LK250 keyboard does not transmit an acknowledge 
(ACK) for codes in this range. 

Request Keyboard ID (ABH) 

DIGITAL Extended 

When the LK250 keyboard receives the code ABH, the keyboard clears its 
output buffer and transmits a 2-byte response that identifies the version and 
mode of the LK250 keyboard. The first byte returned is the version number. 
The second byte is the current operating mode, 01H for industry-standard 
mode or 02H for DIGITAL extended mode. 

To successfully execute this command, the keyboard-interface controller must 
be in pass-through mode. Otherwise, the keyboard controller attempts to 
translate the data to an industry-standard scan code. 

The LK250 keyboard does not transmit an acknowledge (ACK) for this 
command. 

Enter DIGITAL Extended Scan Code Mode (ACH) 

DIGITAL Extended 

When the LK250 keyboard receives the code ACH, the keyboard enables 
DIGITAL extended mode, turns off LED #4, and transmits an acknowledge 
(ACK). 

Exit DIGITAL Extended Scan Code Mode (ADH) 

DIGITAL Extended 

When the LK250 keyboard receives the code ADH, the keyboard enables 
industry-standard mode, turns on LED #4, and transmits an acknowledge 
(ACK). 

In this mode, only industry-standard scan codes are generated. 

Set Keyboard LED (AEH) 

DIGITAL Extended 

When the LK250 keyboard receives the code AEH, the keyboard turns on LED 
#4, and transmits an acknowledge (ACK). For LEDs 1-3, see LEDs On/Off 
(EDH). 
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Reset Keyboard LED (AFH) 

DIGITAL Extended 

When the LK250 keyboard receives the code AFH, the keyboard turns off LED 
#4, and transmits an acknowledge (ACK). For LEDs 1-3, see LEDs On/Off 
(EDH). 

Set Keyclick Volume (BOH) 

DIGITAL Extended 

This is a 2-byte command consisting of a command byte and a value byte. 

When the LK250 keyboard receives the code BOH, the keyboard stops scanning 
for keys, transmits an acknowledge (ACK), and waits for the second byte. 

When the LK250 keyboard receives the second byte, the keyboard sets the 
volume to the indicated value, transmits an acknowledge (ACK) and returns to 
the previous scanning state. 

If bit 7 of the value byte is set to 1, the value is interpreted as a command. 

The current command is aborted, the new command is executed and the LK250 
returns to the previous scanning state. 

The volume value byte can have one of the following values: 


Value 

Volume 

00H 

No keyclick 

02H 

Soft 

04H 

Medium 

06H 

Loud 


Enable Autorepeat (B1H) 

DIGITAL Extended 

When the LK250 keyboard receives the code B1H, the keyboard enables auto¬ 
repeat for all keys and transmits an acknowledge (ACK). Autorepeat enabled is 
the default condition. 

Disable Autorepeat (B2H) 

DIGITAL Extended 

When the LK250 keyboard receives the code B2H, the keyboard disables auto¬ 
repeat for all keys and transmits an acknowledge (ACK). 


8-24 Keyboard-Interface Controller - Hardware Description 




Keyboard Mode Lock (B3H) 

DIGITAL Extended 

When the LK250 keyboard receives the code B3H, the keyboard disables the 
key combination ALT/F17 and transmits an acknowledge (ACK). The key com¬ 
bination ALT/F17 toggles the keyboard between DIGITAL extended mode and 
industry-standard mode. This key combination is detected and handled by the 
keyboard, not the ROM BIOS. 

Keyboard Mode Unlock (B4H) 

DIGITAL Extended 

When the LK250 keyboard receives the code B4H, the keyboard enables the 
key combination ALT/F17 and transmits an acknowledge (ACK). The key com¬ 
bination ALT/F17 toggles the keyboard between DIGITAL extended mode and 
industry-standard mode. This key combination is detected and handled by the 
keyboard, not the ROM BIOS. ALT/F17 enabled is the default condition. 

Reserved (B5H-ECH) 

DIGITAL Extended 

When the LK250 keyboard receives any of the reserved codes B5H-ECH, the 
keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 
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LEDs On/Off (EDH) 

DIGITAL Extended 


This is a 2-byte command consisting of a command byte and a value byte. 

When the LK250 keyboard receives the code EDH, the keyboard stops scan¬ 
ning for keys, transmits an acknowledge (ACK), and waits for the second byte. 
When the LK250 keyboard receives the second byte, the keyboard sets the 
LEDs to the indicated value, transmits an acknowledge (ACK) and returns to 
its previous scanning state. 

If bit 7 of the value byte is set to 1, the value is interpreted as a command. 

The current command is aborted, the new command is executed and the LK250 
returns to the previous scanning state. 

The bits in the LED value byte have the following meanings: 


Bit 

Description 

7-3 

Reserved, always 0 

2 

CapsLock 


0 = CapsLock LED off 

1 = CapsLock LED on 

1 

NumLock 


0 = NumLock LED off 

1 = NumLock LED on 

0 

Scroll Lock 


0 = Scroll Lock LED off 

1 = Scroll Lock LED on 


Echo (EEH) 

Industry-Standard 

When the LK250 keyboard receives the code EEH, the keyboard transmits the 
same echo code (EEH) and continues its previous scanning state. This com¬ 
mand is a diagnostic tool. 

Reserved (EFH-F2H) 

Industry-Standard 

When the LK250 keyboard receives any of the reserved codes EFH-F2H, the 
keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 
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Set Autorepeat Delay and Rate (F3H) 

Industry-Standard 


This is a 2-byte command consisting of a command byte and a value byte. 

When the LK250 keyboard receives the code F3H, the keyboard stops scanning 
for keys, transmits an acknowledge (ACK), and waits for the second byte. 

When the LK250 keyboard receives the second byte, the keyboard sets the 
autorepeat delay and rate to the indicated values, transmits an acknowledge 
(ACK) and returns to its previous scanning state. 

If bit 7 of the value byte is set to 1, the value is interpreted as a command. 

The current command is aborted, the new command is executed and the LK250 
returns to the previous scanning state. 

The bits in the delay and rate value byte have the following meanings: 


Bit Description 


7 Always 0 

6-5 Autorepeat delay (± 20%) 

00 = .25 seconds 

01 = .5 seconds 

10 = .75 seconds 

11 = 1.0 second 

4-0 Autorepeat rate (± 

20 %) 


Bits 4-0 

Rate per second 

Bits 4-0 

Rate per second 

00000 = 

29.98 

10000 = 

7.49 

00001 = 

26.65 

10001 = 

6.66 

00010 = 

23.98 

10010 = 

6.00 

00011 = 

21.80 

10011 = 

5.45 

00100 = 

19.98 

10100 = 

5.00 

00101 = 

18.45 

10101 = 

4.61 

00110 = 

17.13 

10110 = 

4.28 

00111 = 

15.99 

10111 = 

4.00 

01000 = 

14.99 

11000 = 

3.75 

01001 = 

13.32 

11001 = 

3.33 

01010 = 

11.99 

11010 = 

3.00 

01011 = 

10.90 

11011 = 

2.73 

01100 = 

9.99 

11100 = 

2.50 

01101 = 

9.22 

11101 = 

2.31 

OHIO = 

8.56 

11110 = 

2.14 

01111 = 

7.99 

11111 = 

2.00 
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Enable Key Scanning (F4H) 

Industry-Standard 

When the LK250 keyboard receives the code F4H, the keyboard clears its 
output buffer, transmits an acknowledge (ACK), and begins scanning for keys. 
Use of this command assumes that key scanning was previously disabled. Any 
key strokes that were recognized but not transmitted are lost. 

Disable Key Scanning and Restore to Defaults (F5H) 

Industry-Standard 

When the LK250 keyboard receives the code F5H, the keyboard stops scan¬ 
ning, clears its output buffer, restores conditions to the default powerup state, 
transmits an acknowledge (ACK), and waits for additional commands. Keyboard 
scanning remains disabled. Any key strokes that were recognized but not 
transmitted are lost. 


Feature 

Default 

Autorepeat delay 

Autorepeat rate 

ALT/F17 mode toggle 

LEDs 

Digital extended mode 

.5 seconds 

29.98 per second 

Enabled 

Off 

Disabled 

Restore To Defaults (F6H) 

Industry-Standard 


When the LK250 keyboard receives the code F5H, the keyboard stops scan¬ 
ning, clears its output buffer, restores conditions to the default powerup state, 
transmits an acknowledge (ACK), and resumes its previous scanning state. 

Feature 

Default 

Autorepeat delay 

Autorepeat rate 

ALT/F17 mode toggle 

LEDs 

Digital extended mode 

.5 seconds 

29.98 per second 

Enabled 

Off 

Disabled 
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Reserved (F7H-FDH) 

Industry-Standard 

When the LK250 keyboard receives any of the reserved codes F7H-FDH, the 
keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 

Resend (FEH) 

Industry-Standard 

When the LK250 keyboard receives the code FEH, the keyboard repeats its 
last transmission. This command is used when the keyboard-interface controller 
detects a reception error. It can be sent only in response to a transmission 
from the LK250 keyboard. Additionally, the resend command (FEH) must be 
transmitted before the keyboard-interface controller allows the keyboard to 
start another transmission. If the retransmitted data is still bad, the keyboard- 
interface controller places FFH in its output buffer and sets the parity error 
and timeout error status bits. 

Reset (FFH) 

Industry-Standard 

When the LK250 keyboard receives the code FFH, the keyboard transmits an 
acknowledge (ACK) and waits for the the acknowledge to be accepted. Receipt 
of the acknowledge (ACK) is indicated by reading the acknowledge (ACK) from 
the keyboard-interface controller, setting port 2 bits 7-6 to 1, and leaving them 
set for at least 600 jus. When the keyboard recognizes acceptance of the ac¬ 
knowledge (ACK), the keyboard invokes its self-test diagnostic. On completing 
the self-test, the keyboard transmits AAH (self-test success) or FCH (self-test 
failure). As a result of the self-test, the keyboard is reset to default conditions 
and the keyboard output buffer is empty. 


Feature Default 


Autorepeat delay 

.5 seconds 

Autorepeat rate 

29.98 per second 

ALT/F17 mode toggle 

Enabled 

LEDs 

Off 

Digital extended mode 

Disabled 
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LK250 Keyboard Responses 

The LK250 keyboard must reply to every transmission sent to it. Most of the 
time the reply is an acknowledge (ACK), but some commands have special 
responses. Refer to LK250 keyboard command descriptions for details. Table 
8-8 lists the LK250 keyboard responses. 

Table 8-8 LK250 Keyboard Responses 

Value Description 

00H Buffer Overrun 

AAH Self-Test Success 

EEH ECHO 

FAH Acknowledge (ACK) 

FCH Power-Up Self-Test Failure 

FDH Not Used 

FEH Resend 


Buffer overrun (00H) 

Industry-Standard 

This code indicates that the LK250 keyboard output buffer (20 bytes) has been 
filled to capacity (19 key codes) and an attempt was made to store another 
code. The 20th code is replaced with 00H. 

If the keyboard-interface controller is in translate mode, the LK250 keyboard 
buffer-overrun code 00H is translated to an industry-standard buffer overrun 
code of FFH. 

Self-test success (AAH) 

Industry-Standard 

This code indicates successful completion of the LK250 keyboard self-test diag¬ 
nostics. The self-test diagnostics are invoked as part of the powerup sequence 
and by the reset command (FFH). 

ECHO (EEH) 

Industry-Standard 

This code indicates receipt of an echo command (EEH). In response to an echo 
command (EEH), the LK250 transmits echo (EEH) instead of acknowledge 
(ACK) (FAH). 
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Release Prefix (FOH) 

Industry-Standard 

This code indicates that a key was released. It is followed by the scan code of 
the released key. 

If the keyboard-interface controller is in translate mode, this 2-byte sequence is 
translated to an industry-standard 1-byte release code by adding 80H to the 
translated scan code. 

Acknowledge (ACK) (FAH) 

Industry-Standard 

This code is transmitted by the LK250 keyboard in response to most of the 
valid commands. Some commands have special responses. For example, request 
keyboard identification (ABH), echo (EEH), and resend (FEH>. For additional 
information, see the descriptions of the LK250 keyboard commands. 

Self-Test Failure (FCH) 

Industry-Standard 

This code transmitted by the LK250 keyboard to indicate that a keyboard com¬ 
ponent failed the self-test diagnostics. Self-test is invoked during the powerup 
sequence and the reset command (FFH). 

Resend (FEH) 

Industry-Standard 

This code is transmitted by the LK250 keyboard in response to a keyboard- 
interface controller transmission containing a parity error. Providing that the 
last transmission to the keyboard was not a resend command (FEH), the key¬ 
board interrupt handler should retransmit the last keyboard command. 

LK250 Keyboard Error Handling 

If the LK250 keyboard receives an invalid command or a parity error, it replies 
with a resend command. 

U.S. and Foreign Keyboards 

The LK250 keyboard is shipped with key legends appropriate for the destina¬ 
tion country. Figure 8-2 through Figure 8-15 show the key legends for the 
various country keyboards. 
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Figure 8-2 U.S./U.K. Keyboard 
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Figure 8-3 Canadian/English Keyboard 
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Figure 8-4 Danish Keyboard 
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Figure 8-6 French/Canadian Keyboard 
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Figure 8-7 French Keyboard 
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Figure 8-8 German/Austrian Keyboard 
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Figure 8-9 Hebrew Keyboard 
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Figure 8-10 Italian Keyboard 
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Figure 8-11 Norwegian Keyboard 
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Figure 8-12 Spanish Keyboard 
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Figure 8-13 Swedish Keyboard 
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Figure 8-14 Swiss/French Keyboard 
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Figure 8-15 Swiss/German Keyboard 
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Programming Example 

The subroutines in the keyboard example provide keyboard input support for all 
of the examples in this manual. The keyboard example demonstrates: 

• Communicating with the keyboard-interface controller 

• The use of keyboard translation tables 

• Extended features of the LK250 keyboard 

CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The example provides routines as described in the following list. 


wrkcc 

wrkcd 

passthru 

kyb_init 

wrkyb 

kyb_led 

kyb_send 

kyb_rest 

getkey 

kyb_int_hand 

kyb_exm 


Writes a command byte to the keyboard-interface controller 

Writes a data byte to the keyboard-interface controller 

Sets the keyboard-interface controller to pass-through mode 

Prepares the interrupt structure for keyboard interrupts 

Places data in a ring buffer for output to the keyboard 

Turns LEDs on or off according to the keyboard state 

Retrieves data from a ring buffer and writes it to the keyboard 

Restores the previous keyboard interrupt structure 

Gets a 1-byte value from the keyboard input ring buffer 

Handles keyboard-interface-controller interrupts and performs 
scan code translations 

Provides an example environment for examining various aspects 
of the keyboard 


8- 46 


Keyboard-Interface Controller - Programming Example 



#include "rb.h" 
#include "example.h 


/* define constants and structures used in keyboard examples */ 

/***********************************************************************/ 

#define COMMAND 0x64 /* command register in I/O space */ 

#define DATAREG 0x60 /* data register in I/O space */ 

/* define mask bits for keyboard state flag */ 


#define 

S.LSHF 

0x01 

/* left shift key is pressed 

*/ 

#define 

S_RSHF 

0x02 

/* right shift key is pressed 

*/ 

#define 

S_CTRL 

0x04 

/* control key is pressed 

*/ 

#define 

S_ALT 

0x08 

/* Alternate key is pressed 

*/ 

#define 

S_SCRL 

0x10 

/* Scroll lock is in effect 

*/ 

#define 

S_NUM 

0x20 

/* Numerics lock is in effect 

*/ 

#define 

S_CAPS 

0x40 

/* Caps lock is in effect 

*/ 

#define 

S_INS 

0x80 

/* Insert mode is active 

*/ 

/* define modifier-key values returned 

by keyboard */ 


#define 

CTRL 

Oxld 

/* control key 

*/ 

#define 

LSHF 

0x2a 

/* left shift key 

*/ 

#define 

RSHF 

0x36 

/* right shift key 

*/ 

#define 

ALT 

0x38 

/* alternate key */ 

#define 

CAPS 

0x3a 

/* Lock/Caps Lock key 

*/ 

#define 

NUML 

0x45 

/* NumLock key 

*/ 

#define 

SCRL 

0x46 

/* ScrlLock key 

*/ 

#define 

INS 

0x52 

/* Ins (Insert) key 

*/ 

#define 

DEL 

0x53 

/* Del key 

*/ 

/* define some 

keyboard interface controller commands */ 


#define 

RDCB 

0x20 

/* read command byte 

*/ 

#define 

WRCB 

0x60 

/* write command byte 

*/ 
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/* define some keyboard commands */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


LED123 

Oxed 

/* control leds 1,2, and 3 

*/ 

LED4.0N 

Oxae 

/* turn led #4 on 

*/ 

LED4_0F 

Oxaf 

/* turn led #4 off 

*/ 

ENT_EXM 

Oxac 

/* enter DIGITAL extended keyboard mode 

*/ 

EXT_EXM 

Oxad 

/* exit DIGITAL extended keyboard mode 

*/ 

AREPON 

Oxbl 

/* auto-repeat on 

*/ 

AREPOFF 

0xb2 

/* auto-repeat off 

*/ 

SETAR 

Oxf 3 

/* set auto-repeat rate 

*/ 

SETVOL 

OxbO 

/* set speaker volume 

*/ 

KYBID 

Oxab 

/* return keyboard ID and state 

*/ 

RESDEF 

Oxf 6 

/* reset keyboard to default values 

*/ 


/* define some keyboard responses */ 


#define B_FULL 0x00 /* keyboard buffer full */ 
#define RESEND Oxfe /* request to resend command or data */ 
#define ACK Oxfa /* keyboard acknowledge */ 


/* define some state dependent keyboard table index constants */ 
/* Note: The ROM BIOS has separate alpha and numeric tables. */ 
/* This example combines the alpha and numeric tables. */ 


#define 

T_N0RM 

0x00 

#define 

T_ALT 

0x02 

#define 

T_CTRL 

0x04 

#define 

T_SHFT 

0x06 

#define 

TJLN 

0x08 


/* look in normal key table */ 
/* look in alternate combination table */ 
/* look in control key table */ 
/* look in shift table */ 
/* look in alphanumeric table */ 


#define KB_SIZ 128 


/* example keyboard buffer size is 128 bytes */ 
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/***♦**************************★********★************★******★***********/ 
/* define key translation tables and variables */ 

^***********************************************************************/ 


unsigned char kyb.state; 
unsigned char last_send; 
unsigned char key_buff[2][KB_SIZ]; 
unsigned char released; 
unsigned char depressed; 

RINGJ3UFF ki_rb; 

RING.BUFF ko_rb; 


/* state of modifier keys */ 
/* last character sent to keyboard */ 
/* place to store incoming keys */ 
/* last released key for demo */ 
/* last depressed key for demo */ 

/* ring buffer control structure */ 
/* ring buffer control structure */ 


/* define the keyboard tables */ 

/* Note: The ROM BIOS has separate alpha and numeric tables. */ 
/* This example combines the alpha and numeric tables. */ 


static unsigned char keyboard[0x70][9] = 

{ 

/* NORMAL | ALT | CONTROL | SHIFT | A/N */ 


Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

/* overrun 

*/ 

Oxlb, 

0x01, 

Oxff, 

Oxff, 

Oxlb, 

0x01, 

Oxlb, 

0x01, 

0x00, 

/* ESC 

*/ 

0x31, 

0x02, 

0x00, 

0x78, 

Oxff, 

Oxff, 

0x21, 

0x02, 

0x00, 

/* 

1 

*/ 

0x32, 

0x03, 

0x00, 

0x79, 

0x00, 

0x03, 

0x40, 

0x03, 

0x00, 

/* 

2 

*/ 

0x33, 

0x04, 

0x00, 

0x7 a, 

Oxff, 

Oxff, 

0x23, 

0x04, 

0x00, 

/* 

3 

*/ 

0x34, 

0x05, 

0x00, 

0x7b, 

Oxff, 

Oxff, 

0x24, 

0x05, 

0x00, 

/* 

4 

*/ 

0x35, 

0x06, 

0x00, 

0x7 c, 

Oxff, 

Oxff, 

0x25, 

0x06, 

0x00, 

/* S 

*/ 

0x36, 

0x07, 

0x00, 

0x7d, 

Oxle, 

0x07, 

Ox5e, 

0x07, 

0x00, 

/* 6 

*/ 

0x37, 

0x08, 

0x00, 

0x7e, 

Oxff, 

Oxff, 

0x26, 

0x08, 

0x00, 

/* 

7 

*/ 

0x38, 

0x09, 

0x00, 

0x7f, 

Oxff, 

Oxff, 

0x2a, 

0x09, 

0x00, 

/* 

8 

*/ 

0x39, 

0x0a, 

0x00, 

0x80, 

Oxff, 

Oxff, 

0x28, 

OxOa, 

0x00, 

/* 9 

*/ 

0x30, 

0x0b, 

0x00, 

0x81, 

Oxff, 

Oxff, 

0x29, 

OxOb, 

0x00, 

/* 

0 

*/ 

0x2d, 

0x0c, 

0x00, 

0x82, 

Oxlf, 

0x0c, 

Ox5f, 

OxOe , 

0x00, 

/* 

- 

*/ 

0x3d, 

OxOd, 

0x00, 

0x83, 

Oxff, 

Oxff, 

0x2b, 

OxOd, 

0x00, 

/* 

= 

*/ 

0x08, 

OxOe, 

Oxff, 

Oxff, 

0x7f, 

OxOe, 

0x08, 

OxOe, 

0x00, 

/* BS 

*/ 

0x09, 

OxOf, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

OxOf, 

0x00, 

/* TAB 

*/ 

0x71, 

0x10, 

0x00, 

0x10, 

Oxll, 

0x10, 

0x51, 

0x10, 

S.CAPS, 

/* 

q 

*/ 

0x77, 

Oxll, 

0x00, 

Oxll, 

0x17, 

Oxll, 

0x57, 

Oxll, 

S_CAPS, 

/* W */ 

0x65, 

0x12, 

0x00, 

0x12, 

0x05, 

0x12, 

0x45, 

0x12, 

S__CAPS, 

/* 

E 

*/ 

0x72, 

0x13, 

0x00, 

0x13, 

0x12, 

0x13, 

0x52, 

0x13, 

S_CAPS, 

/* 

R 

*/ 

0x74, 

0x14, 

0x00, 

0x14, 

0x14, 

0x14, 

0x54, 

0x14, 

S.CAPS, 

/* 

T 

*/ 

0x79, 

0x15, 

0x00, 

0x15, 

0x19, 

0x15, 

0x59, 

0x15, 

S_CAPS, 

/* 

Y 

*/ 

0x75, 

0x16, 

0x00, 

0x16, 

0x15, 

0x16, 

0x55, 

0x16, 

S_CAPS, 

/* 

U 

*/ 

0x69, 

0x17, 

0x00, 

0x17, 

0x09, 

0x17, 

0x49, 

0x17, 

S_CAPS, 

/* 

I 

*/ 

0x6f, 

0x18, 

0x00, 

0x18, 

OxOf, 

0x18, 

0x4f, 

0x18, 

S_CAPS, 

/* 

0 

*/ 

0x70, 

0x19, 

0x00, 

0x19, 

0x10, 

0x19, 

0x50, 

0x19, 

S_CAPS, 

/* 

P 

*/ 

0x5b, 

Oxla, 

Oxff, 

Oxff, 

Oxlb, 

Oxla, 

0x7b, 

Oxla, 

0x00, 

/* 

[ 

*/ 
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0x5d, 

Oxlb, 

Oxff, 

Oxff, 

Oxld, 

Oxlb, 

Ox7d, 

Oxlb, 

0x00, 

/* i 

*/ 

OxOd, 

Oxlc, 

Oxff, 

Oxff, 

OxOa, 

Oxlc, 

OxOd, 

Oxlc, 

0x00, 

/* RET 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* CTRL 

*/ 

0x61, 

Oxle, 

0x00, 

Oxle, 

0x01, 

Oxle, 

0x41, 

Oxle, 

S.CAPS, 

/* A 

*/ 

0x73, 

Oxlf, 

0x00, 

Oxlf, 

0x13, 

Oxlf, 

0x53, 

Oxlf, 

S_CAPS, 

/* S 

*/ 

0x64, 

0x20, 

0x00, 

0x20, 

0x04, 

0x20, 

0x44, 

0x20, 

S_CAPS, 

/* D 

*/ 

0x66, 

0x21, 

0x00, 

0x21, 

0x06, 

0x21, 

0x46, 

0x21, 

S_CAPS, 

/* F 

*/ 

0x67, 

0x22, 

0x00, 

0x22, 

0x07, 

0x22, 

0x47, 

0x22, 

S_CAPS, 

/* G 

*/ 

0x68, 

0x23, 

0x00, 

0x23, 

0x08, 

0x23, 

0x48, 

0x23, 

S_CAPS, 

/* G 

*/ 

0x6a, 

0x24, 

0x00, 

0x24, 

OxOa, 

0x24, 

0x4a, 

0x24, 

S_CAPS, 

/* J 

*/ 

0x6b, 

0x25, 

0x00, 

0x25, 

OxOb, 

0x25, 

0x4b, 

0x25, 

S_CAPS, 

/* K 

*/ 

0x6c, 

0x26, 

0x00, 

0x26, 

OxOc, 

0x26, 

0x4c, 

0x26, 

S__CAPS, 

/* L 

*/ 

0x3b, 

0x27, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x3a, 

0x27, 

0x00, 

/* ; 

*/ 

0x27, 

0x28, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x22, 

0x28, 

0x00, 

/* ’ 

*/ 

0x60, 

0x29, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Ox7e, 

0x29, 

0x00, 

/* • 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* LS 

*/ 

0x5c, 

0x2b, 

Oxff, 

Oxff, 

Oxlc, 

0x2b, 

0x7c, 

0x2b, 

0x00, 

/* \ 

*/ 

0x7a, 

0x2c, 

0x00, 

0x2c, 

Oxla, 

0x2c, 

0x5a, 

0x2c, 

S_CAPS, 

/* Z 

*/ 

0x78, 

0x2d, 

0x00, 

0x2d, 

0x18, 

Ox2d, 

0x58, 

Ox2d, 

S_CAPS, 

/* X 

*/ 

0x63, 

Ox2e, 

0x00, 

0x2e, 

0x03, 

Ox2e, 

0x43, 

Ox2e, 

S_CAPS, 

/* c 

*/ 

0x76, 

0x2f, 

0x00, 

0x2f, 

0x16, 

Ox2f, 

0x56, 

Ox2f, 

S_CAPS, 

/* V 

*/ 

0x62, 

0x30, 

0x00, 

0x30, 

0x02, 

0x30, 

0x42, 

0x30, 

S_CAPS, 

/* B 

*/ 

0x6e, 

0x31, 

0x00, 

0x31, 

OxOe, 

0x31, 

Ox4e, 

0x31, 

S_CAPS, 

/* N 

*/ 

0x6d, 

0x32, 

0x00, 

0x32, 

OxOd, 

0x32, 

0x4d, 

0x32, 

S.CAPS, 

/* M 

*/ 

0x2c, 

0x33, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x3c, 

0x33, 

0x00, 

/* . 

*/ 

0x2e, 

0x34, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Ox3e, 

0x34, 

0x00, 

/* • 

*/ 

0x2f, 

0x35, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Ox3f, 

0x35, 

0x00, 

/* / 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* Right Shift 

*/ 

0x2a, 

0x37, 

Oxff, 

Oxff, 

0x00, 

0x72, 

Oxff, 

Oxff, 

0x00, 

/* PRTSC 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* ALT 

*/ 

0x20, 

0x39, 

0x20, 

0x39, 

0x20, 

0x39, 

0x20, 

0x39, 

0x00, 

/* Space Bar 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* CAPS Lock 

*/ 

0x00, 

0x3b, 

0x00, 

0x68, 

0x00, 

Ox5e, 

0x00, 

0x54, 

0x00, 

/* FI 

*/ 

0x00, 

0x3c, 

0x00, 

0x69, 

0x00, 

Ox5f, 

0x00, 

0x55, 

0x00, 

/* F2 

*/ 

0x00, 

0x3d, 

0x00, 

0x6a, 

0x00, 

0x60, 

0x00, 

0x56, 

0x00, 

/* F3 

*/ 

0x00, 

0x3e, 

0x00, 

0x6b, 

0x00, 

0x61, 

0x00, 

0x57, 

0x00, 

/* F4 

*/ 

0x00, 

0x3f, 

0x00, 

0x6c, 

0x00, 

0x62, 

0x00, 

0x58, 

0x00, 

/* FS 

*/ 

0x00, 

0x40, 

0x00, 

0x6d, 

0x00, 

0x63, 

0x00, 

0x59, 

0x00, 

/* F6 

*/ 

0x00, 

0x41, 

0x00, 

0x6e, 

0x00, 

0x64, 

0x00, 

0x5a, 

0x00, 

/* FT 

*/ 

0x00, 

0x42, 

0x00, 

0x6f, 

0x00, 

0x65, 

0x00, 

0x5b, 

0x00, 

/* F8 

*/ 

0x00, 

0x43, 

0x00, 

0x70, 

0x00, 

0x66, 

0x00, 

0x5c, 

0x00, 

/* F9 

*/ 

0x00, 

0x44, 

0x00, 

0x71, 

0x00, 

0x67, 

0x00, 

Ox5d, 

0x00, 

/* F10 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* NumLock 

*/ 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

0x00, 

Oxff, 

Oxff, 

0x00, 

/* ScrlLock 

*/ 

0x00, 

0x47, 

0x07, 

0x00, 

0x00, 

0x77, 

0x37, 

0x47, 

S_NUM, 

/* keypad 7 

*/ 

0x00, 

0x48, 

0x08, 

0x00, 

Oxff, 

Oxff, 

0x38, 

0x48, 

S_NUM, 

/* keypad 8 

*/ 

0x00, 

0x49, 

0x09, 

0x00, 

0x00, 

0x84, 

0x39, 

0x49, 

S_NUM, 

/* keypad 9 

*/ 
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0x2d, 

0x4a, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Ox2d, 

0x4a, 

0x00, 

/* keypad - 

*/ 

0x00, 

0x4b, 

0x04, 

0x00, 

0x00, 

0x73, 

0x34, 

0x4b, 

S.NUM, 

/* keypad 4 

*/ 

Oxff, 

Oxff, 

0x05, 

0x00, 

Oxff, 

Oxff, 

0x35, 

0x4c, 

S_NUM, 

/* keypad 6 

*/ 

0x00, 

0x4d, 

0x06, 

0x00, 

0x00, 

0x74, 

0x36, 

0x4d, 

S_NUM, 

/* keypad 6 

*/ 

0x2b, 

0x4e, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x2b, 

0x4e, 

0x00, 

/* keypad + 

*/ 

0x00, 

0x4f, 

0x01, 

0x00, 

0x00, 

0x75, 

0x31, 

0x4f, 

S_NUM, 

/* keypad 1 

*/ 

0x00, 

0x50, 

0x02, 

0x00, 

Oxff, 

Oxff, 

0x32, 

0x50, 

S_NUM, 

/* keypad 2 

*/ 

0x00, 

0x51, 

0x03, 

0x00, 

0x00, 

0x76, 

0x33, 

0x51, 

S_NUM, 

/* keypad 3 

*/ 

0x00, 

0x52, 

0x00, 

0x00, 

Oxff, 

Oxff, 

0x30, 

0x52, 

S_NUM, 

/* keypad 0 

*/ 

0x00, 

0x53, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Ox2e, 

0x53, 

S_NUM, 

/* keypad . 

*/ 

0x00, 

0x98, 

Oxff, 

Oxff, 

0x00, 

OxbO, 

0x00, 

0xa4, 

0x00, 

/* F20 

*/ 

0x00, 

0x85, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* FIND 

*/ 

0x00, 

0x86, 

Oxff, 

Oxff, 

0x00, 

Oxc3, 

Oxff, 

Oxff, 

0x00, 

/* INSERT 

*/ 

0x00, 

0x87, 

Oxff, 

Oxff, 

0x00, 

Oxcl, 

Oxff, 

Oxff, 

0x00, 

/* REMOVE 

*/ 

0x00, 

0x88, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* SELECT 

*/ 

0x00, 

0x89, 

Oxff, 

Oxff, 

0x00, 

Oxc4, 

Oxff, 

Oxff, 

0x00, 

/* PREV 

*/ 

0x00, 

0x8a, 

Oxff, 

Oxff, 

0x00, 

Oxc2, 

Oxff, 

Oxff, 

0x00, 

/* NEXT 

*/ 

0x00, 

0x8b, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* UP 

*/ 

0x00, 

0x8c, 

Oxff, 

Oxff, 

0x00, 

Oxbf, 

Oxff, 

Oxff, 

0x00, 

/* LT 

*/ 

0x00, 

0x8d, 

Oxff, 

Oxff, 

0x00, 

OxcO, 

Oxff, 

Oxff, 

0x00, 

/* RT 

*/ 

0x00, 

0x8e, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

Oxff, 

0x00, 

/* DN 

*/ 

0x00, 

0x8f, 

0x00, 

Oxb3, 

0x00, 

Oxa7, 

0x00, 

0x9b, 

0x00, 

/* Fll 

*/ 

0x00, 

0x90, 

0x00, 

0xb4, 

0x00, 

Oxa8, 

0x00, 

0x9c, 

0x00, 

/* F12 

*/ 

0x00, 

0x91, 

0x00, 

Oxb5, 

0x00, 

0xa9, 

0x00, 

0x9d, 

0x00, 

/* F13 

*/ 

0x00, 

0x92, 

0x00, 

0xb6, 

0x00, 

Oxaa, 

0x00, 

0x9e, 

0x00, 

/* F14 

*/ 

0x00, 

0x93, 

0x00, 

Oxb7, 

0x00, 

Oxab, 

0x00, 

0x9f, 

0x00, 

/* FIB 

*/ 

0x00, 

0x94, 

0x00, 

Oxb8, 

0x00, 

Oxac, 

0x00, 

OxaO, 

0x00, 

/* F16 

*/ 

0x00, 

0x95, 

0x00, 

0xb9, 

0x00, 

Oxad, 

0x00, 

Oxal, 

0x00, 

/* F17 

*/ 

0x00, 

0x96, 

0x00, 

Oxba, 

0x00, 

Oxae, 

0x00, 

Oxa2, 

0x00, 

/* F18 

*/ 

0x00, 

0x97, 

0x00, 

Oxbb, 

0x00, 

Oxaf, 

0x00, 

Oxa3, 

0x00, 

/* F19 

*/ 

0x00, 

Oxbd, 

0x00, 

Oxbd, 

0x00, 

Oxbd, 

0x00, 

Oxbd, 

0x00, 

/* COMPOSE 

*/ 

OxOd, 

0x9a, 

0x00, 

Oxbe, 

0x00, 

Oxb2, 

0x00, 

0xa6, 

0x00, 

/* ENTER 

*/ 


>; 
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/sk**********************************************************************/ 

/* wr_kcc() - Write keyboard controller command */ 

wr_kcc(cmd) 

unsigned char cmd; /* command byte to write */ 

{ 

outp(COMMAND, cmd); /* write command byte */ 

while((inp(COMMAND) 6 0x02)) /* wait until KC has read command */ 

i 

> 

/***********************************************************************/ 

/* wr_kcd() - Write keyboard controller data */ 

/sk**********************************************************************/ 

wr_kcd(data) 

unsigned char data; /* data byte to write */ 

{ 

outp(DATAREG, data); /* write command data */ 

while((inp(COMMAND) ft 0x02)) /* wait until KC has read data */ 

i 

> 
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/*******************************************%***%***********************/ 
/* pass_thru() - set keyboard controller pass through mode */ 

/I***********************************************************************/ 


pass_thru(flag) 


int flag; 

{ 

unsigned char c; 
unsigned int intr_flag; 


/* if TRUE, set pass through */ 
/* else clear pass through */ 

/* tmp to hold internal command byte */ 
/* tmp to hold CPU IF state */ 


intr_flag = int_off(); 
wr_kcc(RDCB); 

whiled (inp(COMMAND) ft 0x01)) 


/* turn interrupts off */ 
/* give me current command byte */ 
/* wait until output buffer full */ 


c = inp(DATAREG); /* read command byte from data buffer */ 
if(flag) c ft= ~0x40;/* if TRUE, do not decode keyboard transmissions */ 
else c 1= 0x40; /* else, decode keyboard transmissions */ 
wr.kcc(WRCB); /* tell interface controller to write command byte */ 
wr_kcd(c); /* send command byte to write */ 
int_on(intr_flag); /* allow interrupts */ 


/* kyb_init() - keyboard interrupt initialization */ 


kyb_init() 


kyb_8tate =0; /* no states established */ 

/* establish ring buffers */ 
init_rb(ftki.rb, ftkey.buff[0][0], KB_SIZ, 30, 15); 
init_rb(ftko_rb, ftkey_buff[1][0], KB_SIZ, 30, 15); 

imask(0,1,0); /* disable PIC input for keyboard interface */ 

iv_init(0x09); /* keyboard interrupt is int 0x09 */ 

imask(0,1,1); /* enable PIC input for keyboard interface */ 
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/***********************************************************************/ 

/* wr.kybQ - put value in output buffer to keyboard and start send */ 


wr.kyb(value) 
unsigned char value; 

{ 

unsigned intr.flag; 

intr.flag = int.offO; 
rb.in (Ako.rb, value) ; 
if(!last.send) kyb.send(0); 
int_on( intr.flag); 


/* value to send to keyboard */ 


/* to hold current CPU IF state */ 

/* CPU interrupts off */ 
/* put value in ring buffer */ 
/* if keyboard not waiting for ACK */ 
/* allow interrupts now */ 


/*9|c9|c3fe9ic$*3|c$»|c$9|'3ic$)|c;!'3|«9ic9|c;|c9|t$$**$»ie9ie9|c$9ic$9|c9|e9|c9ie9|c9|c$;ic9!c9ic9ic ****************£*** ********/ 

/* kyb.ledO - handle changes to LED state */ 

/He**********************************************************************/ 


kyb.ledO 

{ 

unsigned char state; /* temporary state variable */ 


state = kyb.state » 4; 
state ft* 0x07; 
wr.kyb(LED123); 
wr.kyb(state); 


/* shift into position */ 
/* only bits 2:0 are valid */ 
/* keyboard LED command to buffer */ 
/* LED state to buffer */ 


/* kyb.sendO - send command to keyboard */ 

/***********************************************************************/ 

kyb_send(resend) 

int resend; /* re-send character if true */ 

{ 

if(resend) outp(DATAREG, last.send); /* re-send command or data */ 

else if(rb.out(ftko.rb, ftlast.send) >= 0)/* get char from output buff */ 
outp(DATAREG, last.send); /* send command or data */ 

else last.send =0; /* no character to send */ 

> 
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/***********************************************************************/ 
/* kyb_rest() - restore keyboard interrupts to system */ 

/***********************************************************************/ 

kyb.rest() 

< 

iv_rest(0x09); /* keyboard interrupt is int 0x09 */ 

> 

/* get_key() - get character from keyboard input buffer */ 

f *********************************************************************** f 

int get.key(pc) /* get char from input buf */ 

unsigned char *pc; /* where to put character */ 

{ 

return(rb.out(fcki.rb, pc)); /* get char from input buff */ 

> 

/* put.keyO - put key sequence into keyboard input buffer */ 

/He**********************************************************************/ 

int put.key(pc) /* put key seq into input buf */ 

unsigned char *pc; /* where to get sequence */ 

i 

if(pc[0] == Oxff kk pc[l] == Oxff) beep(); /* invalid key combo ? */ 

else 

{ 

rb_in(&ki_rb, *pc++); /* write ASCII character */ 

return(rb_in(&ki_rb, *pc)); /* write scan code */ 

> 

> 
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/♦sit*********************************************************************/ 

/* kyb_int_hand() - keyboard interrupt handler */ 

/**************************************★*****************************★**/ 


kyb_int.hand() 

{ 


unsigned char key; 


/* tmp to hold keyboard transmission */ 


key * inp(DATAREG); /* get keyboard transmission */ 

if(key == B.FULL) beep(); /* tell typist, buffer full */ 

else if(key k 0x80) /* key release or keyboard reply ? */ 

{ 

switch(key) 

{ 

case ACK: /* keyboard acknowledge ? */ 

kyb.send(O); 
break; 


case RESEND: /* keyboard re-send request ? */ 

kyb.send(l); 
break; 


default: 

switch(released * key k 0x7f) 
case CTRL: 

kyb.state &“ ~S_CTRL; 
break; 

case LSHF: 

kyb.state k- ~S_LSHF; 
break; 

case RSHF: 

kyb.state k- ^S.RSHF; 
break; 


/* must be a key release */ 
/* save released key for demo */ 
/* and check modifier keys */ 
/* control key released ? */ 
/* clear from state byte */ 

/* left shift key released ? */ 
/* clear from state byte */ 

/* right shift key released ? */ 
/* clear from state byte */ 


case ALT: 

kyb.state &= ~S_ALT; 
break; 


/* alternate key released ? */ 
/* clear from state byte */ 


case CAPS: 
case NUML: 
case SCRL: 
break; 


/* caps lock, numlock or scrllock released ? */ 
/* these are toggle keys, only means it was */ 
/* released, toggle is performed when pressed */ 
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case INS: 

kyb.state A* ~S_INS; 
break; 

default: 
break; 

> 

> 

> 

else switch(depressed ■ key k OxTf) 
case CTRL: 

kyb.state I* S.CTRL; 
break; 

case LSHF: 

kyb.state |= S.LSHF; 
break; 

case RSHF: 

kyb.state |= S.RSHF; 
break; 

case ALT: 

kyb.state |« S.ALT; 
break; 

case CAPS: 

if(kyb.state k S.CAPS) 
kyb.state A= ~S_CAPS; 
else kyb.state |= S.CAPS; 
kyb.ledO ; 
break; 

case NUML: 

if(kyb.state k S.NUM) 
kyb.state k= ~S.NUM; 
else kyb.state |= S.NUM; 
kyb.ledO ; 
break; 

case SCRL: 

if(kyb.state k S.SCRL) 
kyb.state &= ~S.SCRL; 
else kyb.state |= S.SCRL; 
kyb.ledO ; 


/* insert key released ? */ 
/* clear from state byte */ 

/* no default */ 


/* save depress key for demo */ 

/* control key pressed ? */ 
/* set in state byte */ 

/* left shift key pressed ? */ 
/* set in state byte */ 

/* right shift key pressed ? */ 
/* set in state byte */ 

/* alternate key pressed ? */ 
/* set in state byte */ 

/* caps lock key pressed ? */ 
/* caps on ? */ 
/* turn caps off */ 
/* otherwise, turn caps on */ 
/* adjust Lock LED */ 

/* numlock key pressed ? */ 
/* numlock on ? */ 
/* turn numlock off */ 
/* otherwise, turn numlock on ? */ 
/* adjust NumLock LED */ 

/* scrllock key pressed ? */ 
/* scrllock on ? */ 
/* turn scrllock off */ 
/* otherwise, turn scrllock on */ 
/* adjust ScrlLock LED */ 
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break; 

case INS: /* insert key pressed ? */ 

kyb_state |= S_INS; /* set in state byte */ 

break; 

default: /* test for combination keys */ 

if(kyb_state k S_ALT) /* alt key pressed ? */ 

if(kyb_state k S_CTRL) /* Ctrl key pressed ? */ 

if (key == DEL) sys^resetO; /* CTRL/ALT/DEL ? */ 

else beepO; /* NOTE: No ALT/CTRL table in demo. */ 

> 

else if(kyb_state k (S_LSHF | SJISHF)) /* shift key pressed ? */ 

{ 

beepO; /* NOTE: No ALT/SHIFT table in demo */ 

> 

else put_key(&keyboard[key][T_ALT]); /* use alt table */ 

> 

else if(kyb_state k S_CTRL) /* Ctrl key pressed ? */ 

if(kyb_state A (S_LSHF I S_RSHF)) /* shift key pressed ? */ 

{ 

beepO; /* NOTE: No CTRL/SHIFT table in demo */ 

> 

else put_key(&keyboard[key][,T_CTRL]); /* use Ctrl table */ 

> 

else if(kyb_state k (S_LSHF | SJRSHF)) /* shift key pressed ? */ 

if(keyboard[key][T_A_N] k S_CAPS) /* alpha character ? */ 

if(kyb_state k S_CAPS) /* caps lock in effect ? */ 

put_key(fckeyboard[key][T_NORM]); /* use normal table ? */ 

else put__key(&keyboard[key] [T_SHFT]) ; /* use shift table */ 
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> 

else if(keyboard[key][T_A_N] k S_NUM) /* numeric character ? */ 

if(kyb_state k S_NUM) /* numlock in effect ? */ 

put_key(&keyboard[key][T_NORM]); /* use normal table */ 

else put_key(&keyboard[key][T_SHFT]); /* use shift table */ 

> 

else put_key(&keyboard[key][T_SHFT]); /* use shift table */ 

> 

else put_key(&keyboard[key][T_N0RM]); /* use normal table */ 

break; 

> 

eoi(O); /* end of interrupt to PIC */ 

> 
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/* kyb.exmO - keyboard example program */ 

kyb_exm() 

i 

static MESSAGE mmain[] = /* opening menu */ 

{ 

{ 3, 24, "Keyboard Example” >, 

{ 5, 24, ”F1. Toggle DIGITAL extended mode on or off" }, 

{ 6, 24, "F2. Set key click volume” >, 

{ 7, 24, "F3. Toggle autorepeat on or off” }, 

{ 8, 24, "F4. Set autorepeat delay and rate” }, 

{ 9, 24, ”F5. Show keyboard version and mode” >, 

{ 10, 24, "F6. Restore keyboard to defaults” >, 

{ 11, 24, ”F7. Show last depressed and last released keys” }, 

{ 12, 24, ”F10. Return to Main menu” }, 

i 0, 0, 0 >, 

>; 


char line[512]; 
int ext.mode = 0; 
int auto.rep = 0; 
int d; 
int x; 
int y; 

unsigned int intr.flag; 


/* to hold input line */ 
/* to hold extended mode toggle state */ 
/* to hold auto-repeat toggle state */ 
/* to hold input */ 
/* to hold input */ 
/* to hold input */ 
/* to hold CPU IF state */ 


#define ROW 14 /* where to put input lines */ 

#define COL 17 


wr_kyb(AREP0N); 
wr.kyb(EXTJEXM) ; 
wr_kyb(LED4_0N); 
line[0] = 0; 
while(l) 

disp_menu(mmain); 
switch(line[0]) 

{ 

case FI: 

if(ext_mode) 

wr^kyb(EXT^EXM); 
wr_kyb(LED4_0N); 
ext.mode■* 0; 

> 


/* ensure autorepeat is on */ 
/* exit extended mode */ 
/* led #4 on */ 

/* null line */ 

/* forever until F10 */ 

/* display menu for keyboard example */ 

/* which function key ? */ 

/* toggle extended mode */ 
/* in extended mode ? */ 

/* exit extended mode */ 
/* led #4 on */ 
/* clear toggle */ 
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/* not in extended mode */ 


else 

< 

wr_kyb(ENT_EXM); 
wr_kyb(LED4_0F); 
ext_mode - 1; 

} 

break; 


/* enter extended mode */ 
/* led #4 off */ 
/* set toggle */ 


case F2: /* change keyclick volume */ 

disp.str(ROW, COL, 

"The key click volume has a range of 0 to 6 in 4 increments"); 
disp_str(ROW + 1, COL, 

"0 = Off 2 = Low 4 = Medium 6 « High”); 
disp_str(R0W + 7, COL, 

"Enter key click volume (0 - 6):"); 
get_keys(ROW + 7, COL + 36, line); /* get chioce */ 

sscanf(line, "%d", fcy) ; /* ascii to int */ 

if (y < 0 | | y > 6) y = 4; /* keep it in bounds */ 

wr_kyb(SETVOL); /* write set volume command */ 

wr_kyb(y); /* write volume data */ 

break; 


case F3: 

if(auto_rep) 

wr_kyb(AREPON); 
auto^rep = 0; 

> 

else 

wr.kyb(AREPOFF); 
auto_rep = 1; 

> 

break; 


/* toggle auto-repeat 7 */ 
/* auto-repeat off ? */ 

/* autorepeat on */ 
/* clear toggle */ 

/* auto-repeat is on */ 

/* autorepeat off */ 
/* set toggle */ 


case F4: /* set auto-repeat rate ? */ 

disp_str(ROW, COL, 

"The autorepeat rate has a range of 2 to 30 in 32 increments”); 
disp_str(ROW + 1, COL, 

"The autorepeat rate is calculated as follows:”); 
disp_str(ROW + 2, COL, 

"Rate = 1 / (.00417 * (2~Y) * (X + 8)"); 
disp_str(RQW + 3, COL, 

"The delay, before autorepeat begins, has a range of"); 
disp__str(ROW + 4, COL, 

".25 seconds to 1 second in .25 second increments"); 
disp_str(ROW + 5, COL, 
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"The delay, before autorepeat begins, is calculated as follows:"); 
disp.str(ROW + 6, COL, "delay - (D + 1) * .25"); 
disp_str(ROW + 7, COL, 

"Enter repeat rate Y value (0 - 3):"); 
disp.str(ROW + 8, COL, 

"Enter repeat rate X value (0 - 7):"); 
disp_str(ROW + 9, COL, 

"Enter delay value D (0 - 3):"); 
get_keys(ROW + 7, COL + 36, line); 
sscanf(line, "%d", Ay); 
if (y < 0 | | y > 3) y * 2; 
getJkeys(ROW + 8, COL + 36, line); 
sscanf(line, "%d", ftx); 
if (x <0 || x>3) x = 2; 
get_keys(ROW + 9, COL + 30, line); 
sscanf(line, "%d", Ad); 
if (d < 0 | | d > 3) d - 2 ; 
y «= 3; 


*/ 

*/ 


d «= 5; 
wr_kyb(SETAR); 
wr_kyb(d I y I x); 
break; 


/* get input */ 
/* ascii to int */ 
/* keep in bounds */ 
/* get input 
/* ascii to int 
/* keep in bounds */ 
/* get input */ 
/* ascii to int */ 
/* keep in bounds */ 
/* shift into correct position */ 
/* shift into correct position */ 
/* write set auto-repeat rate command */ 
/* write auto-repeat data */ 


case F5: 

intr_flag = int_off(); 
pas8_thru(TRUE); /* interface 

wr_kcd(KYBID); 

while(!(inp(COMMAND) k 0x01)) 


/* read keyboard ID and state */ 
/* CPU interrupts off */ 
controller in pass-through mode */ 
/* write keyboard ID command */ 
/* wait until data available */ 


y = inp(DATAREG); 

whiled (inp(COMMAND) k 0x01)) 


/* read version byte */ 
/* wait until data available */ 


x = inp(DATAREG); 
pass.thru(FALSE); /* 

int_on(intr_flag); 
if(x == 2) 


/* read mode byte */ 
interface controller interprets */ 
/* CPU interrupts on */ 
/* DIGITAL extended mode ? */ 


sprintf(line, 

"Keyboard version #%d is in DIGITAL extended mode %d", y, x); 
else /* industry-standard mode */ 

sprintf(line, 

"Keyboard version #%d is in industry-standard mode %d", y, x); 
disp_str(ROW, COL, line); /* display data */ 

break; 


case F6: /* reset keyboard to default values ? */ 

wr__kyb(RESDEF) ; /* write reset to default command */ 

break; 
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case F7: /* show last pressed and last released keys ? */ 

line[0] - 0; /* null line */ 

disp_str(R0W, 0, "Press F7 again to cancel"); 

while(line[0] !*= 0 | | line[l] !* F7) /* F7 terminates */ 

sprintf(line, "Last depressed: %02x", depressed); 
disp_str(RQW +3, 0, line); 

sprintf(line, "Last released: %02x", released); 
disp_str(R0W + 3, 40, line); 

chk^dtO; /* display date and time ? */ 

if(get_key(&line[0])) /* scan code */ 

while(!get_key(fcline[1])) /* character code */ 


> 

break; 

case F10: 
return; 

> 

line[0] = get_fkey(); /* get menu selection */ 
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Chapter 9 
Serial Communications 


Overview 

The 8250A universal asynchronous receiver/transmitters (UART) in the 
VAXmate workstation provide asynchronous communications for the communi¬ 
cations port, the printer port, and the modem port. 

The 8250A UART converts parallel data from the internal buses to serial data 
for transmission to external devices. The 8250A UART receives serial data and 
converts it to parallel data for the internal buses. The serial data has the 
format of a start bit; five to eight data bits; an optional parity bit; and 1, 1-1/2, 
or 2 stop bits. 

The 8250A UART also has a programmable baud rate generator. 

Additional Sources of Information 

The following documents provide additional information on programming the 
8250A UART serial communications devices. 

• Series 8000 Microprocessor Family Handbook (National Semiconductor 
Corporation) 

• 1984 Data Communications Products Handbook (Western Digital 
Corporation) 
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8250A UART Registers 


Table 9-1 lists the 8250A UART registers and their registers at each port. 
Table 9-1 8250A UART Register Addresses 


Register 

Coml 

Modem 

(Com2) 

Printer 

Receive buffer (Read)/Transmit 
holding register (Write) or 

Divisor latch (LSB) * 

03F8H 

02F8H 

OCAOH 

Interrupt enable 
or Divisor latch (MSB) * 

03F9H 

02F9H 

0CA1H 

Interrupt identification 

03FAH 

02FAH 

0CA2H 

Line control 

03FBH 

02FBH 

0CA3H 

Modem control 

03FCH 

02FCH 

0CA4H 

Line status 

03FDH 

02FDH 

0CA5H 

Modem status 

03FEH 

02FEH 

0CA6H 


* Bit 7 of the line control register controls access to the divisor latches. 
The line control register is described later in this chapter. 
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Receive Buffer Register/Transmitter Holding Register 
(03F8H/02F8H/0CA0H) 


7 6 5 

4 3 

2 1 

0 

i 1 1 

1 

i 



DATA BITS 



_1_1_L 

_1_1 

1_1_1 

I__ 

Bit R/W Description 


7-0 R Reading this register accesses the receive buffer. 


W Writing this register accesses the transmitter holding register. 

Bit 0 (the least significant bit) is the first bit transmitted or 
received. 

When the line control register is programmed for word lengths of 
less than 8 bits, the unused bits are read as zeros. 

When bit 7 of the line control register is set to 1, reading or writ¬ 
ing this register accesses the least significant byte of the divisor 
latch. 
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Interrupt Enable Register (03F9H/02F9H/0CA1H) 

7 6 5 4 3 2 1 0 






MODEM 

RECEIVE 

THRE 

RECEIVE 





STATUS 

LINE 

INTRPT 

DATA 





INTRPT 

STATUS 


AVAIL 

0 

0 

0 

0 


INTRPT 


INTRPT 


Bit R/W Description 


7-4 R/W Always 0 

3 R/W MODEM STATUS INTRPT - Modem Status Interrupt 
0 = Modem status interrupt disabled 
1 = Modem status interrupt enabled 

2 R/W RECEIVE LINE STATUS INTRPT - Receive Line Status 
Interrupt 

0 = Receive line status interrupt disabled 
1 = Receive line status interrupt enabled 


1 R/W THRE INTRPT - Transmit Holding Register Empty Interrupt 
0 = Transmit holding register empty interrupt disabled 
1 = Transmit holding register empty interrupt enabled 

0 R/W RECEIVE DATA AVAIL INTRPT - Receive Data Available 
Interrupt 

0 = Receive data available interrupt disabled 
1 = Receive data available interrupt enabled 


Writing all Os to this register disables the 8250A UART interrupt structure. If 
any of bits 3-0 are set, the 8250A UART interrupt structure is enabled. Only 
the functions with set bits can cause an interrupt. 

Because the 8250A UART has only one interrupt output line, you must read 
the interrupt identification register to determine which function or functions 
caused the interrupt. Later in this chapter, the interrupt identification register 
description defines the interrupt conditions for each function. 

NOTE 

Each 8250A UART has a buffer between the interrupt output 
line and the peripheral interrupt controller input. This buffer is 
controlled by bit 3 of the modem control register. Writing a 1 to 
bit 3 of the modem control register enables the buffer and there¬ 
fore, the 8250A UART interrupt output line. The modem control 
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register is described later in this chapter. 

To use the 8250A UART in an interrupt-driven environment you 
must program the peripheral interrupt controller. For more in¬ 
formation on the peripheral interrupt controller, see Chapter 3. 
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Interrupt Identification Register (03FAH/02FAH/0CA2H) 


7 

6 

5 

4 

3 

2 1 

0 

0 

0 

0 

0 

0 

INTERRUPT 

IDENTIFICATION 

_1_ 

INTRPT 

PENDING 


Bit R/W Description 


7-3 R 

2-1 R 

0 R 

Always 0 

INTERRUPT IDENTIFICATION 

These two bits identify the highest priority interrupt pending. 
Table 9-2 defines the meaning of the interrupt identification bits. 

INTRPT PENDING - Interrupt Pending 

0 = One or more interrupts pending 

1 = No interrupts pending 

Table 9-2 

Interrupt Identification 



Priority 

Interrupt 

Interrupt 

Interrupt 

Interrupt 

Level 

ID Bits 

2 1 

Enable 

Register 

Bit 

Condition 

Reset 

Highest 

1 1 

Receiver line 
status 

Overrun, parity 
error, framing 
error, or break 
interrupt 

Reading the line 
status register 

Second 

1 0 

Receive data 
available 

Assembling a 
complete word 
in the receive 
buffer 

Reading the re¬ 
ceive buffer 
register 

Third 

0 1 

Transmit hold¬ 
ing register 
empty 

Transmit hold¬ 
ing register 
empty 

Writing the 
transmit holding 
register 

Fourth 

0 0 

Modem status 

Change in state 
of CTS, DSR, 
RI, or RLSD 
signals 

Reading the 
modem status 
register 
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Line Control Register (03FBH/02FBH/0CA3H) 


7 

6 

5 

4 

3 

2 

1 0 

DLAB 

BREAK 

STICK 

PARITY 

PARITY 

STOP 

i 

VORD LENGTH 


CONTROL 

PARITY 

SELECT 

ENABLE 

BITS 

_1_ 


Bit R/W Description 


7 


6 

5 


4 


R/W DLAB - Divisor latch access bit 

0 = Access to the divisor latch is disabled 
1 = Access to the divisor latch is enabled 

When access to the divisor latch is enabled, the least significant 
byte of the divisor latch is read or written through the receive 
buffer/transmit holding register, and the most significant byte of 
the divisor latch is read or written through the interrupt enable 
register. 

The divisor latch is described later in this chapter. 

R/W BREAK CONTROL 
0 = Break disabled 

1 = A space (logic 0) state forced on the serial output 

R/W STICK PARITY , 

0 = Stick parity disabled 

1 = If parity is enabled (bit 3 equals 1), stick parity is enabled 

When stick parity is enabled, the parity bit is transmitted and 
received in the following manner: 

• If bit 4 equals 1, the parity bit is always transmitted and 
received as a 0. 

• If bit 4 equals 0, the parity bit is always transmitted and 
received as a 1. 

R/W PARITY SELECT 

0 = Even parity (except for stick parity as described in bit 5) 

1 = Odd parity (except for stick parity as described in bit 5) 
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Bit R/W Description (Line Control Register - cont.) 

3 R/W PARITY ENABLE 

0 = Parity disabled 
1 = Parity enabled 

2 R/W STOP BITS 

0 = 1 stop bit 

I = 1-1/2 stop bits (5-bit word length) 

2 stop bits (6, 7, or 8-bit word length) 

This bit sets the number of stop bits only for transmitted 
characters. The receiver uses only the first stop bit detected. 

1-0 R/W WORD LENGTH 

00 = 5 data bits 

01 = 6 data bits 

10 = 7 data bits 

II = 8 data bits 

When reading the receive buffer, unused bits are read as 0. 
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Modem Control Register (03FCH/02FCH/0CA4H) 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

LOOP 

0UT2 

0UT1 

RTS 

DTR 


Bit 

R/W 

Description 

7-5 

R/W 

Always 0 

4 

R/W 

LOOP 

0 = Diagnostic loopback disabled 

1 = Diagnostic loopback enabled (see the discussion that follows! 

3 

R/W 

OUT2 

0 = The buffer between the 8250A UART interrupt output and 
the peripheral interrupt controller input is disabled. 

1 = The buffer between the 8250A UART interrupt output and 
the peripheral interrupt controller input is enabled. 



Each 8250A UART has a buffer between the interrupt output line 
and the peripheral interrupt controller input. This buffer is con¬ 
trolled by bit 3. Enabling the buffer enables the 8250A UART in¬ 
terrupt output line. 



To use the 8250A UART in an interrupt-driven environment you 
must program the peripheral interrupt controller. For more infor¬ 
mation on the peripheral interrupt controller, see Chapter 3. 

2 

R/W 

OUT1 (not connected to anything) 

1 

R/W 

RTS - Request to send 

0 = RTS is a logic 0 at the external connector 

1 = RTS is a logic 1 at the external connector 

0 

R/W 

DTR - Data terminal ready 

0 = DTR is a logic 0 at the external connector 

1 = DTR is a logic 1 at the external connector 


NOTE 

See the section "Modem Control Programming Exceptions" in 
this chapter. 
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Diagnostic Loopback 

When the diagnostic loopback is enabled, the following conditions exist: 

• The serial output at the external connector is set to a space (logic 0) 
state. 

• The serial input is internally disconnected. 

• The output of the transmit shift register is internally connected to the 
input of the receive shift register. 

• The four modem inputs (DSR, CTS, RI, and RLSD) are internally 
disconnected. The four modem outputs (DTR, RTS, OUT1, and OUT2) 
are connected to the four modem inputs as follows: 

The DTR output is connected to DSR input 
The RTS output is connected to the CTS input 
The OUT1 output is connected to the RI input 
The OUT2 output is connected to the RLSD input 

When the diagnostic loopback is enabled, the receive and transmit interrupts 
continue to function normally. The modem control and the line status inter¬ 
rupts are also functional, but the source of the interrupt is changed as follows: 

• The line status interrupt is activated by writing an appropriate value to 
one of the line status register bits 5-0. A set bit creates the interrupt 
condition. 

• The modem status interrupt is activated by writing an appropriate value 
to one of the modem status register bits 3-0. A set bit creates the inter¬ 
rupt condition. 
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Line Status Register (03FDH/02FDH/0CA5H) 

76543210 



XMIT 

XMIT 

BREAK 

FRAMING 

PARITY 

OVERRUN 

RECEIVE 


SHIFT 

HOLDING 

INTRPT 

ERROR 

ERROR 

ERROR 

DATA 


REG 

REG 





READY 

0 

EMPTY 

EMPTY 







Bit R/W Description 

7 R Always 0 

6 R XMIT SHIFT REG EMPTY - Transmit Shift Register Empty 

0 = Transmit shift register contains data being transmitted 
1 = Transmit shift register is empty 

This bit is cleared by writing data to the transmit holding register. 

5 R XMIT HOLDING REG EMPTY - Transmit Holding Register 

Empty 

0 = Transmit holding register is full. 

1 = The 8250A UART is ready to accept a character for 

transmission. If the transmit holding register interrupt 
enable bit (interrupt enable register) is set, this condition 
creates an interrupt. 

This bit is cleared by writing data to the transmit holding register. 

4 R/W BREAK INTRPT - Break Interrupt 

0 = Break interrupt is not active 

1 = The serial input line at the connector has been held in a 
mark (logic 1) state for longer than a full character 
transmission, including start and stop bits. 

This bit is cleared by reading this register or writing the bit. 

3 R/W FRAMING ERROR 

0 = No framing error 

1 = The received character did not have a stop bit. 

This bit is cleared by reading this register or writing the bit. 
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Bit R/W Description (Line Status Register - cont.) 


2 


1 


0 


R/W PARITY ERROR 

0 = No parity error 

1 = Received character did not have the correct parity. 

This bit is cleared by reading this register or writing the bit. 

R/W OVERRUN ERROR 

0 = No overrun error 

1 — The CPU did not read the data in the Receive Buffer regis¬ 
ter before the next character was received. Thus, the unread 
character was destroyed. 

This bit is cleared by reading this register or writing the bit. 

R/W RECEIVE DATA READY 

0 = Receive data buffer is empty. 

1 = A complete character has been received and assembled into 
the receive Buffer register. 

This bit is cleared by reading this register or writing the bit. 


When any of bits 4-1 are set, a receiver line status interrupt is generated. 
When bit 0 is set, a receive data available interrupt is generated. 
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Modem Status Register (03FEH/02FEH/0CA6H) 

76543210 


RLSD 

RI 

DSR 

CTS 

DELTA 

TRAIL 
EDGE OF 

DELTA 

DELTA 





RLSD 

RI 

DSR 

CTS 


Bit R/W Description 

7 R RLSD - Received line signal detect 

0 = RLSD at external connector is a logic 0 
1 = RLSD at external connector is a logic 1 

6 R RI - Ring indicator 

0 = RI at the external connector is a logic 0 
1 = RI at the external connector is a logic 1 

5 R DSR - Data set ready 

0 = DSR at the external connector is a logic 0 
1 = DSR at the external connector is a logic 1 

4 R CTS - Clear to send 

0 = CTS at the external connector is a logic 0 
1 = CTS at the external connector is a logic 1 

3 R DELTA RLSD - Delta Receive Line Signal Detect 

0 = RLSD has not changed state. 

1 = Since the last time this register was read, the RLSD bit has 
changed state. 

Reading this register clears the bit. 

2 R TRAIL EDGE OF RI - Trailing Edge Of Ring Indicator 

0 = The ring indicator has not changed state. 

1 = Since the last time this register was read, the ring indicator 
at the external connector changed from a logic 0 to a logic 1. 

Reading this register clears the bit. 
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Bit R/W Description (Modem Status Register - cont.) 


1 R Delta DSR - Delta Data Set Ready 

0 = DSR has not changed state. Reading the register clears the 
bit. 

1 = Since the last time this register was read, the DSR signal 
has changed state. 

Reading this register clears the bit. 

0 R Delta CTS - Delta Clear to Send 

0 = CTS has not changed state. 

1 = Since the last time this register was read, the CTS signal 
has changed state. 

Reading this register clears the bit. 


If any of bits 3-0 in the Modem Status register are set, a modem status inter¬ 
rupt is generated. 

Bits 7-4 are the complement of the signal levels at the chip input pins. 
However, the RS-232 receiver buffer inverts these signals, so the bits reflect 
the true state of the lines at the external connector. 
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Divisor Latches 

7 6 

5 4 3 

2 

1 

0 

1 1 

i i i 

DIVISOR LATCH 


1 


1 1 

LEAST SIGNIFICANT BYTE 

1 1 1 


1 


15 14 

13 12 11 

10 

9 

8 

1 1 

i . i .r. 

DIVISOR LATCH 


\ I 

1 

1 1 

MOST SIGNIFICANT BYTE 

_ 1 _1_1_ 


_1 _ ! 

1 


When bit 7 of the line control register (Divisor latch access bit) is equal to 1, 
the least significant byte of the divisor latch is read or written through the 
receive buffer/transmit holding register, and the most significant byte of the 
divisor latch is read or written through the interrupt enable register. 

These two, 8-bit latches store a 16-bit divisor in the range 1 to 66,535. The 
output frequency of the baud rate generator is 1.8432 Mhz divided by the 16- 
bit divisor. These divisors must be loaded during initialization. The desired 
output frequency is 16 times the desired baud rate. Table 9-3 lists the divisor 
used for the standard baud rates. Table 9-3 was calculated using the following 
formula: 


divisor = (1843200 / 16) / desired baud rate 
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Table 9-3 Baud Rate Table 


Baud Rate 

Divisor 

Percentage of Error Between Desired 
and Actual Rate 

50 

2304 

- 

75 

1536 

- 

110 

1047 

- 0.026 

134.5 

857 

+0.058 

150 

768 

- 

200 

576 

- 

300 

384 

- 

600 

192 

- 

1200 

96 

- 

1800 

64 

- 

2000 

58 

+ 0.69 

2400 

48 

- 

3600 

32 

- 

4800 

24 

- 

7200 

16 

- 

9600 

12 

- 

19200 

6 

- 

38400 

3 

- 
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Modem Control Programming Exceptions 

Speed Select and Speed Indicator control signals are not controlled by the 
8250A UART. Instead, these signals are controlled by writing to a special pur¬ 
pose register. 

The special purpose register is located at I/O address 0C80H. 

NOTE 

When changing the Speed Select or Split Baud Rate, maintain 
the integrity of the other bits in this register. Split baud rates 
are achieved by switching the output (RCLK H> between two 
sources, BD OUT CLK (baud out of the 8250A UART) and a 
1200 baud counter. 
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Special Purpose Register (0C80H) 


7 

6 

5 

4 

3 

2 

1 

0 

WRITE 

PROTECT 

TRACK 0 

INDEX 

SPEED 

DISABLE 

VIDEO 

SPLIT 

BAUD 

DISABLE 

COMM 

SPEED 

SELECT 


Bit R/W Description 


7 

6 


5 


4 


3 


2 


1 


0 


R Write protect 

0 = Selected diskette drive is not write protected 
1 = Selected diskette drive is write protected 

R Track 0 

0 = Head of selected diskette drive is not at track 0 
1 = Head of selected diskette drive is at track 0 

R Index 

0 = Index hole not in position for selected diskette drive 
1 = Index hole in position for selected diskette drive 

R Speed Indicator 

0 = Modem control speed select asserted 
1 = Modem control speed select not asserted 

R7W Disable Video 

0 = Video controller disabled 
1 = Video controller enabled 

R/W Split Baud Rates 

0 = (Receive = Transmit = programmed) 

1 = (Receive = 1200) (Transmit = programmed) 

R/W Disable Communications 

0 = Integral communications ports connected to I/O address 
space 

1 = Integral communications ports disconnected from I/O address 
space 

R/W Speed Select 

0 = Speed select asserted 
1 = Speed select not asserted 
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Communications Connector Signals 

The communications connector, a 25-pin, male, D-subminiature, is located on 
the rear bezel of the VAXmate workstation. This connector is functionally 
compatible with RS-232-C and electrically compatible with RS-423, configured 
as DTE (Data Terminal Equipment). Table 9-4 lists the signals supported by 
this connector. 

Table 9-4 Communications Connector Signals 


Pin Signal Name 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 


Protective ground 

Transmitted Data 

Received Data 

Request to Send 

Clear to Send 

Data Set Ready 

Signal ground 

Receive Line Signal Detect 


Not used 
Speed Indicator 


Data Terminal Ready 

Ring Indicator 
Speed Select 
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Printer Connector Signals 

The printer connector is a 6-pin MMJ, female, modified modular connector 
located on the rear bezel of the VAXmate workstation. Table 9-5 lists the sig¬ 
nals this connector supports. 


Table 9-5 

Printer Connector Signals 

Pin 

Signal Name 

1 

Data Terminal Ready 

2 

Transmit Data 

3 

Transmit Common (Signal ground) 

4 

Receive Common (Signal ground) 

5 

Receive Data 

6 

Data Set Ready 
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Modem Connector Signals 

The modem connectors are modular TELCO (telephone line) compatible connec¬ 
tors located on the optional modem board, protruding through the rear panel of 
the VAXmate workstation. The connectors use an 8-pin, keyed modular housing 
for an RC11C jack (or CA11 jack in Canada). Table 9-6 lists the signals for a 
modem connector. Table 9-7 lists the signals for a handset connector. 

Table 9-6 Modem Telephone Line Connector Signals 


Pin No. 

Signal Name Meaning 

1 

N.C. 

No connection 

2 

N.C. 

No connection 

3 

MIC 

Not used 

4 

TIP 

TELCO signal source 

5 

RING 

TELCO signal return 

6 

MI 

Not used 

7 

N.C. 

No connection 

8 

N.C. 

No connection 


Table 9-7 

Handset Connector Signals 

Pin No. 

Signal Name 

Meaning 

i 

N.C. 

No connection 

2 

N.C. 

No connection 

3 

MIC 

Not used 

4 

RING 

TELCO signal return 

5 

TIP 

TELCO signal source 

6 

MI 

Not used 

7 

N.C. 

No connection 

8 

N.C. 

No connection 
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Programming Example 

The examples in this chapter demonstrate: 

• Initializing an 8250A UARTA serial communications device 

• Handling interrupt-driven serial I/O 

• Handling hardware and software handshaking protocols 

CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The example provides routines as described in the following list: 


device_init 

device_open 

ser_out 

restart 

device_int 

device_close 

put_buf 

putsjbuf 

get_buf 

so 

int_coml 

intmodm 

int_prnt 


Establishes a known state for a serial port 

Activates the serial port and interrupts 

Handles character transmissions 

Activates interrupt-driven serial transmissions 

Coordinates all of the device interrupts 

Deactivates the serial port and interrupts 

Puts a character into a ring buffer from the application 

Puts a string of characters into a ring buffer from the 
application 

Gets a character from a ring buffer for the application 
The serial example 

An interrupt vector entry point for the coml serial port 
interrupt handler 

An interrupt vector entry point for the modem serial port 
interrupt handler 

An interrupt vector entry point for the serial printer port 
interrupt handler 
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Program Description 


Constant Value Description 


PENAB through W0RD5 

RDRDY through BREAK 

ENA_MOD through 
ENATHE 

DTR through LOOP 

RLSD through CTS 

HHS through DEV OFF 

CLKRATE 

NO_PAR through S BIT2 


Define the line control register bit values. 

Define the line status register bit values. 

Define the interrupt enable register bit values. 

Define the modem control register bit values. 

Define the modem status register bit values. 

Define the bit values used to maintain the driver 
status. The driver status is part of the structure 
type DEV_DAT. 

Is divided by the desired baud rate to give the 
value for the baud rate divisor registers. 

Clarify the logic of the function, device_init. 
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#include "kyb.h" 

#include "rb.h" 

#include "example.h" 


/***********************************************************************/ 
/* define constant values used in example serial driver */ 


/* define line control register bit values */ 


#define P_ENAB 0x08 
#define P_EVEN 0x10 
#define P_0DD 0x00 
#define P_STIK 0x20 
#define W0RD8 0x03 
#define W0RD7 0x02 
#define W0RD6 0x01 
#define WORDS 0x00 


/* parity enabled */ 
/* EVEN parity select */ 
/* ODD parity select */ 
/* enable stick parity */ 
/* 8-bit word size */ 
/* 7-bit word size */ 
/* 6-bit word size */ 
/* 5-bit word size */ 


/* define line status register bit values */ 


#define RDRDY 0x01 
#define THRE 0x20 
#define ERRORS OxOe 
#define BREAK 0x10 


/* received data ready */ 
/* transmit holding reg empty */ 
/* overrun, parity, framing */ 
/* received break */ 


/* define interrupt enable register bit values */ 


#define ENA_M0D 0x08 
#define ENA_REC 0x05 
#define ENA.THE 0x02 


/* enable modem status */ 
/* recv line stat & rd rdy */ 
/* enable trans hold empty */ 
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/* define modem control register bit values */ 


#define DTR 0x01 
#define RTS 0x02 
#define 0UT2 0x08 
#define LOOP 0x10 


/* data terminal ready */ 
/* request to send */ 
/* out 2 interrupt Ctrl */ 
/* loopback mode */ 


/* define modem status register bit 

#define RLSD 0x80 
#define RI 0x40 
#define DSR 0x20 
#define CTS 0x10 


values */ 

/* recv line signal detect */ 
/* ring indicator */ 
/* data set ready */ 
/* clear to send */ 


/* define driver status bit values */ 

#define HHS 0x80 
#define F_X0FF 0x40 
#define F_X0N 0x20 
#define DEV.CLS 0x10 
#define SWAIT 0x04 
#define DEV_0FF 0x01 

/* define some general constants */ 

#define CLK_RATE 11B200L 
#define X_0FF 0x13 
#define X..0N Oxll 


/* use hardware handshake */ 
/* x-off pending flag */ 
/* x-on pending flag */ 
/* device close request */ 
/* sending stopped */ 
/* driver off line */ 


/* 1843200 / 16 = 115200 */ 
/* x-off (DC3) character */ 
/* x-on (DC1) character */ 


/* program constants used to initialize the line control register */ 


#define NONPAR 0 
#define EV_PAR 1 
#define 0D.PAR 2 
#define SC^PAR 3 
#define SS^PAR 4 
#define S.BIT2 0x04 


/* no parity */ 
/* even parity */ 
/* odd parity */ 
/* stick parity clear */ 
/* stick parity set */ 
/* 2 stop bits */ 
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The structure type SERIAL declares the relationship of the 8250A UART reg¬ 
isters in I/O space. The registers accessed by the members rtbl and iebh 
depends on the following: 

• If bit 7 of the line control register is set, rtbl accesses the low byte 
of the baud rate divisor and iebh accesses the high byte of the baud 
rate divisor. 

• If bit 7 of the line control register is clear, rtbl accesses the receive 
register when reading and the transmit register when writing, and 
iebh accesses interrupt enable register. 

The structure type DEVJJAT stores the characteristics of the individual de¬ 
vices, the current status, and the pointers to the buffers. 

/* define structures used in example serial driver */ 


typedef struct 

unsigned char rtbl; 
unsigned char iebh; 
unsigned char int_ident; 
unsigned char line_ctrl; 
unsigned char modem_ctrl; 
unsigned char line_stat; 
unsigned char modem.stat; 
> SERIAL; 


/* receive/transmit/baud low */ 
/* int enable reg/baud high */ 
/* int identification reg */ 
/* line control register */ 
/* modem control register */ 
/* line status register */ 
/* modem status register */ 


typedef struct dev_dat 
{ 


> 


SERIAL 

♦base; 

/* base i/o address of device 

*/ 

unsigned int 

pic; 

/* PIC number it belongs to 

*/ 

unsigned int 

ir_bit; 

/* IR bit in PIC 

*/ 

unsigned int 

baud; 

/* desired baud rate 

*/ 

unsigned int 

word.siz; 

/* desired word size 

*/ 

unsigned int 

parity; 

/* even, odd, none, stick 

*/ 

unsigned int 

stop_bits; 

/♦ 1, 1 - 1/2, 2 

*/ 

unsigned int 

req_dsr; 

/* DSR required flag 

*/ 

RING.BUFF 

*prbi; 

/* ptr to input ring buff 

*/ 

RINGJBUFF 

*prbo; 

/* ptr to output ring buff 

*/ 

unsigned char 
DEV_DAT; 

8tat_drv; 

/* state of driver 

*/ 


void int_on(); 
int int_off(); 
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The function devicejinit establishes a known state for the 8250A UARTA 
serial device. Two items of interest are stick parity and stop bits. If stick 
parity is selected, the parity bit is set to the opposite state of the even/odd 
parity bit. If more than one stop bit is selected, the number of stop bits 
depends on the word size. If the word size is five data bits, there are 1 1/2 stop 
bits. All other word sizes generate 2 stop bits. These characteristics are a func¬ 
tion of the device, not the code. 


/* device_init() - establish a known state for a serial port */ 

void device_init(pdd) /* initialize serial port */ 

register DEV_DAT *pdd; /* pointer to device data */ 




unsigned int tbaud; 
unsigned char tpar; 
register SERIAL *ps; 

tbaud = CLK.RATE / pdd->baud; 
switch(pdd->parity) 

< 

case NOJPAR: 
tpar = N0_PAR; 
break; 

case EV_PAR: 

tpar = P_ENAB | PJEVEN; 
break; 

case 0D_PAR: 

tpar = P_ENAB I P_0DD; 
break; 

case SC_PAR: 
tpar = P_ENAB | 
break; 

case SSJPAR: 

tpar = PJENAB | P_STIK | P_0DD; 
break; 

> 

switch(pdd->word_siz) 


/* temp to hold results */ 
/* temp to collect results */ 
/* pointer to SERIAL struct */ 

/* calculate baud rate divisor */ 


/* no parity */ 


/* even parity */ 


/* odd parity */ 


/* stick, parity bit clear */ 


/* stick, parity bit set */ 


/* desired word size ? */ 


P_STIK | P_EVEN; 
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{ 


case 8: 

tpar I* W0RD8; 
break; 

case 7: 

tpar |* WORD?; 
break; 

case 6: 

tpar |* W0RD6; 
break; 

case 5: 

tpar |= WORDS; 
break; 

> 

if(pdd->stop_bits) tpar |* SJBIT2; 
ps = pdd->base; 
outp(Aps->iebh, 0); 
outp(fcps->modem_ctrl, LOOP); 
outp(4ps->line_ctrl, 0x80); 
outp(&ps->rtbl, tbaud); 
outp(&ps->iebh, tbaud » 8); 
outp(*ps->line_ctrl, tpar); 
pdd->stat_drv I= DEV^OFF; 


/* 8 data bits ? */ 


/* 7 data bits ? */ 


/* 6 data bits */ 


/* S data bits ? */ 

/* set stop bits */ 
/* get shorter pointer */ 
/* interrupts off */ 
/* put in loopback mode */ 
/* access baud rate divisor */ 
/* baud rate divisor lo byte */ 
/* baud rate divisor hi byte */ 
/* bits per char, parity */ 
/* transmit int off */ 
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The function device_opert prepares the driver to handle interrupts and the 
device to receive characters. Because the modem interrupt has the lowest prior¬ 
ity, it is enabled only for hardware handshaking. In that instance, it notifies 
the driver to restart character transmissions. 

Setting the modem control register bit OUT2 connects the 8250A UARTA in¬ 
terrupt output to the 8259A interrupt input. This bit must be set to operate a 
serial device in an interrupt-driven environment. 

/ * ** **** ******* * ********** * * **** 5k * * * * * * **** * 3k* * ** * *********** * * * ** * * * * * * / 

/* device_open() - activate serial port and interrupts */ 

/***********************************************************************/ 


void device_open(pdd) 
register DEV_DAT *pdd; 

register SERIAL *ps; 


/* open a device */ 
/* pointer to device data */ 


/* pointer to SERIAL struct */ 


ps = pdd->base; 
inp(&ps->rtbl); 
inp(Aps~>line_stat); 
if(pdd->stat_drv A HHS) 

if((inp(fcps->modem__8tat) k (DSR | 
pdd->stat_drv &= ~SWAIT; 
else pdd->stat_drv |= SWAIT; 
outp(&ps->iebh, ENA_REC | ENA.MOD) 

> 

else outp(Aps->iebh, ENA_REC); 
pdd->stat_drv &= ~DEV_0FF; 
imask(pdd->pic, pdd->ir_bit, ON); 
outp(&ps->modem_ctrl, DTR|RTS|0UT2); 


/* get shorter pointer */ 
/* empty receive data buffer */ 
/* clear status flags */ 
/* if hardware handshake */ 

CTS)) == (DSR | CTS)) 

/* mark as ok */ 
/* mark as not ok */ 
; /* receive, line k modem */ 

/* just receive and line */ 
/* driver state * online */ 
/* clr the interrupt mask */ 
/* set modem control bits */ 
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The function ser_out provides a single location for maintaining or restarting 
interrupt-driven transmissions. It also provides a method for software hand¬ 
shake characters to preempt normal data transmissions. To prevent continuous 
interrupts, when the output buffer is empty, the transmit interrupt is disabled. 


/* ser_out() - transmit interrupt startup and maintenance */ 

/***********************************************************************/ 


ser_out(pdd) 

register DEV_DAT *pdd; /* pointer to device data */ 

i 


register SERIAL *ps; /* pointer to SERIAL struct */ 
char c; /* character to transmit */ 
int flag; 

void device_clo8e(); 


ps - pdd->base; 

if(inp(Aps->line_stat) k 0x20 kk 
(inp(&ps~>modem_8tat) k DSR I I 
!pdd->req_dsr)) 

if(pdd->stat_drv k FJCOFF) 

pdd->stat_drv &= ~F_X0FF; 
c = X_0FF; 
flag = 1; 

> 

else if(pdd->stat_drv k F_X0N) 

pdd->stat_drv k- ~F_X0N; 
c = X_0N; 
flag = 1; 

> 

else if(!(pdd->stat_drv k SWAIT)) 

flag = rb_out(pdd->prbo, Ac); 
if(flag > -1) flag = 1; 
else 

flag = 0; 

if(pdd->stat_drv k DEV_CLS) 


/* get shorter pointer */ 

/* if terminal ready */ 
/* or dsr not required */ 

/* pending x-off request ? */ 

/* clear pending flag */ 
/* send x-off */ 

/* pending x-on request ? */ 

/* clear pending flag */ 
/* send x-on */ 

/* terminal ready */ 

/* request character to send */ 
/* character to send ? */ 
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{ 

device_close(pdd); 
return; 

> 

> 

> 

else flag = 0; 

> 

else flag = 0; 
if(flag) 

outp(ftps->iebh, inp(ftps->iebh) | ENA.THE); 
outp(ftps->rtbl, c) ; 

> 

else / 

outp(ftps->iebh, inp(ftps->iebh) ft ~ENA_THE); 


* enable transmit int */ 
/* output character */ 
disable transmit int */ 
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The function restart tests the interrupt enable register to determine if inter¬ 
rupts are currently enabled. If they are not, it calls ser^out to restart interrupt- 
driven transmissions. 


/ * * * * * * * * * * * * ******* * **** * * * *** * * * * ****** ****** * * ****** * *** * * He******** * * / 

/* restart - attempt to restart interrupt-driven serial transmissions */ 

/sfc**********************************************************************/ 

void restart(pdd) /* restart serial output */ 

register DEVLDAT *pdd; /* pointer to device data */ 

{ 


int flag; 


/* temporary */ 


if(!(inp(&pdd->base->iebh) A ENA_THE)) 

{ 

flag ■ int_off(); 
ser.out(pdd); 
int_on(flag); 

> 

> 


/* need to restart ? */ 

/* CPU interrupts off */ 
/* restart */ 
/* allow interrupts */ 
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The functions comljint ; modem jint, and printer jnt are interrupt handlers for 
the serial devices. These interrupt handlers call a common interrupt handler, 
device _int. 

/* coml_int() - interrupt handler for coml serial device */ 

void coml_int() 

i 

extern DEV.DAT devdat[]; 
void device.int(); 

device..int (Adevdat [0] ) ; /* call common interrupt handler */ 

> 

/* modem_int() - interrupt handler for modem serial device */ 

/$|c£*$:!c:|c:|cHc$:fcHc****$*******************Mc*$***:k’|c’lc*’|c’l')|c’!c*’|c*****)|e3te*9|c)|c*:|e*$*3|c*4e**/ 

void modem, int () 

{ 

extern DEV.DAT devdat[]; 
void device.int(); 

device.int(Adevdat[1]); /* call common interrupt handler */ 

> 

/***********************************************************************/ 

/* printer.int() - interrupt handler for printer serial device */ 

/ft**********************************************************************/ 

void printer.int() 

i 

extern DEV.DAT devdat[]; 
void device.int(); 

device.int(ftdevdat[3] ) ; /* call common interrupt handler */ 

> 
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The function deviceJint is the major function within the device driver. It 
coordinates interrupt processing, handshake protocol, and peripheral interrupt 
controllers. For any given serial device, this function processes all pending in¬ 
terrupts during a single CPU interrupt. This reduces the CPU interrupt proc¬ 
essing overhead. 

Device communication errors are noted by placing a question mark in the input 
stream. 

The switch values are tested against the contents of the interrupt identification 
register. 

/* device_int() - interrupt handler for serial device */ 


void device_int(pdd) 


/* interrupt handler */ 


register DEV^DAT *pdd; /* pointer to device data */ 

i 


register SERIAL *ps; 
unsigned char r_val; 


/* pointer to SERIAL struct */ 
/* register value read */ 


ps = pdd->base; /* get shorter pointer */ 

while (!((r_val = inp(ftps->int_ident)) & 1)) /* while int pend */ 


switch(r_val) 
case 6: 

inp(&ps->line__stat) ; 
if(inp(Aps->modem_8tat) A DSR II 
!pdd->req_dsr) 

rb_in(pdd->prbi, 

> 

break; 


/* discover which interrupt */ 

/* receive error int */ 
/* clear error */ 
/* if terminal ready */ 
/* or dsr not required */ 

/* show error */ 


case 4: 

r_val = inp(&ps->rtbl); 
if(inp(ftps->modem_stat) & DSR 
!pdd->req_dsr) 

if((pdd->stat_drv k HHS) == 
8witch(r_val & 0x7f) 


/* receive data ready int */ 
/* read character */ 
II /* if terminal ready */ 

/* or dsr not required */ 

0) /* software handshake ? */ 
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/* x-off character ? */ 


i 

case X_0FF: 

pdd->stat_drv |® SWAIT; 
break; 

case X_0N: 

pdd->stat_drv &= ~SWAIT; /* x-on character ? */ 

restart(pdd); 

break; 


default: 

if(rb_in(pdd->prbi, r_val) < 1) /* save character */ 

{ /* if buffer near full */ 

pdd->stat_drv |= F_X0FF; /* stop input */ 

restart(pdd); /* restart if needed */ 

> 

break; 

> 

> 


else if(rb_in(pdd->prbi, r_val) < 1) /* save character */ 

outp(Aps->modem_ctrl, DTR I 0UT2); /* no input please */ 

> 

break; 


case 2: /* xmit hold reg empty int */ 

ser_out(pdd); /* transmit character */ 

break; 


> 


> 


case 0: /* modem status int */ 

if(pdd->stat_drv k HHS) /* hardware handshake ? */ 

if((inp(£ps->modem_stat) k (DSR | CTS)) == (DSR | CTS)) 

i 

if(pdd->stat_drv k SWAIT) /* send stopped ? */ 

i 

pdd->8tat_drv k= "'SWAIT; /* mark as ok */ 

restart(pdd); 


> 

else pdd->stat_drv |= SWAIT; /* mark as not ok */ 

break; 


eoi(pdd->pic); 

> 
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The function device_close disables all interrupts related to the device indicated. 
It also puts the modem control lines in an off-line state. 


/***********************************************************************/ 
/* device_close() - deactivate serial port interrupts */ 

void device_close(pdd) /* close a device */ 


register DEV_DAT *pdd; 


outp(Apdd->base->modem_ctrl, 0); 
outp(Apdd->base->iebh, 0); 

*/ 

imask(pdd~>pic, pdd->ir_bit, OFF); 
pdd->stat^drv |= DEV_0FF; 


/* pointer to device data */ 


/* device offline */ 

/* 8250A UART interrupts off 

/* mask the interrupt */ 

/* driver state ■ offline */ 
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The function putjbuf loops until it has stored the indicated character in an 
output buffer. After storing the character, it ensures that the transmit inter¬ 
rupt is enabled. The companion function putsjbuf processes a null terminated 
string by calling put_buf at each character in the string. The null terminator is 
not processed. 

^9|e$:|c3|c9|c9|e*:|c3|c9|c:ic]|c$**************$**H'***********H<*****$’|c*H'’|c**:|c3|c9|e$’|c>ic**4e***>l'’l<4:*/ 

/* put_buf() - put character in output buffer */ 

/a***********************************************************************/ 


void put_buf(pdd, c) 

register DEV_DAT *pdd; 
char c; 


int flag; 
int r_val; 

for(flag - -1; flag < 0;) 

{ 

flag = rb_in(pdd->prbo, c); 
restart(pdd); 

> 


/* put char in output buf */ 

/* pointer to device data */ 
/* char to put in buffer */ 

/* temporary */ 

/* wait until success */ 
/* attempt to store */ 


/***********************************************************************/ 

/* putsjbuf() - put string in to output buffer */ 

/ft**********************************************************************/ 


void puts_buf(pdd, pc) 

register DEV_DAT *pdd; 
char *pc; 

i 

int flag; 
while(*pc) 

putjbuf(pdd, *pc++); 

> 


/* string into output buf */ 

/* pointer to device data */ 
/* pointer to string */ 


/* while string not done */ 
/* do another character */ 
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The function get_buf attempts to retrieve a character from the input buffer. If 
no characters are available, it returns a -1 value. It also handles the input 
handshake protocol. 

/sic********’!c*************************************************************/ 

/* get__buf() - get character from input buffer */ 

/He**********************************************************************/ 


int get_buf(pdd) 
register DEV_DAT *pdd; 


char c; 
int flag; 

flag = rb_out(pdd->prbi, Ac); 
if(flag < 0) return(flag); 
if(flag == 0) 

if(!(pdd->stat_drv k HHS)) 

pdd->stat_drv |= F_XQN; 
restart(pdd); 


/* get char from input buf */ 
/* pointer to device data */ 


/* temp to hold character */ 

/* get char from input buff */ 
/* no characters available */ 
/* room to restart flow ? */ 
/* and receive stopped */ 
/* software handshake ? */ 

/* set x-on flag */ 


else outp(&pdd->base->modem_ctrl, DTR|RTS|0UT2); 

} 

flag = c; 

return(flag k Oxff); /* return character */ 


/* reserve storage for variables used in example serial driver */ 

/******************** Jjcojc ************************************************#/ 


#define BUF_SIZ 100 
#define HIWATER 75 
#define LOWATER 25 

#define C0M1 (SERIAL *)0x03f8 
#define MODEM (SERIAL *)0x02f8 
#define PRINTER (SERIAL *)0x0CA0 


/* size of buffers */ 
/* buffer near full value */ 
/* buffer near empty value */ 

/* base address of coml */ 
/* base address of modem */ 
/* base address of printer */ 


RINGJBUFF rb[6]; 

char buff[3][2][BUF_SIZ]; 

DEV_DAT devdat[3] = 


/* ring buff Ctrl structs */ 
/* ring buffers */ 
/* device data tables */ 
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i 

{ C0M1, 0, 4, 9600, 8, NO_PAR, 0, 1, 

■C MODEM, 0, 3, 1200, 8, NO.PAR, 0, 1, 

{ PRINTER, 1, 3, 4800, 8. NO.PAR, 0, 0, 

>; 


*rb[0], ftrb[l], 0 >, 
&rb[2], *rb[3], 0 >, 
<trb[4] , Arb[B] , 0 >, 
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The function so drives the examples by transmitting or receiving serial data. It 
initializes the devices and data structures, executes the example and then 
closes the device. 


/* so() - example application that uses serial driver */ 

/***** ******************************************************************/ 

B0() 

{ 

static MESSAGE mso[] - /* opening menu */ 


i 

3. 

25, 

"Serial Communications Example" >, 

< 

5, 

24, 

"FI. 

Select the C0M1 port" >, 


6. 

24, 

"F2. 

Select the Modem (COM2) port 


7, 

24, 

"F3. 

Select the Printer port" 


8, 

24, 

"F4. 

Transmit sample data" }, 

< 

9, 

24, 

"F5. 

Receive data" }, 


10, 

24, 

"F10. 

Return to Main menu" }, 


{ 0 , 0 , 0 }, 

>; 

register DEV.DAT *pdd; 

int i; 

int s; 

int col; 

int flag; 

char line[512]; 

unsigned int intr_flag; 


/* pointer to device data */ 
/* loop control */ 
/* loop control */ 
/* display position */ 
/* hold state of CPU IF */ 
/* to hold input line */ 
/* to hold CPU IF state */ 


ford = 0; i < 2; i++) 
pdd = &devdat[i]; 

init_rb(pdd->prbi, ftbuff[i][0][0], 
init_rb(pdd->prbo, Abuff[i][1][1], 
if(pdd->pic == 0) s = 0x08; 
else s = 0x70; 
intr_flag = int_off(); 
iv_init(s + pdd->ir_bit); 
device_init(pdd); 
device_open(pdd); 
int_on(intr_flag); 

> 

line[0] = 0; 
while(l) 

{ 


/* get pointer to data */ 
BUF.SIZ, HIWATER, L0WATER); 
BUF_SIZ, HIWATER, LOWATER); 

/* base vector for master pic */ 
/* base vector for slave pic */ 
/* no interrupts allowed */ 
/* init interrupt vectors */ 
/* init serial device */ 
/* activate device */ 
/* allow interrupts */ 

/* null line */ 
/* forever until F10 */ 
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disp_menu(mso); /* 

line[0] = get_fkey(); 
switch(line[0]) 

case FI: 

pdd = ftdevdat[0]; 
break; 

case F2: 

pdd = &devdat[l]; 
break; 

case F3: 

pdd * fcdevdat[2]; 
break; 


display menu for serial example */ 
/* get menu selection */ 
/* which function key ? */ 

/* select coml port */ 
/* get pointer to data */ 

/* select modem (COM2) port */ 
/* get pointer to data */ 

/* select printer port */ 
/* get pointer to data */ 


case F4: /* transmit sample text */ 

disp_str(14, 0, 'Tress F4 again to cancel"); 

i - 0; 

while(line[0] != 0 || line[l] != F4) /* F4 terminates */ 

sprintf(feline[0], "This is line %d\r\n", i++); 
put s _buf(pdd, 1ine); 
disp_str(15 f 0, line); 

chk_dt(); /* display date and time ? */ 

if(get_key(&line[0])) /* scan code */ 

while(!get_key(&line[l])) /* character code */ 

> 

break; 

case F5: /* receive serial data */ 

disp_str(14, 0, "Press F5 again to cancel"); 
col = 0; 

while(line[0] != 0 || line[l] !» F5) /* F5 terminates */ 

i = get__buf (pdd) ; 
if(i > -1) 

i *= 0x7f; 

di8p_t(16, col++, i, 0x07); 

if(i == ’\r’ II i == ’\n’) col = 0; 

if(col — 80) col = 0; 

> 

chk_dt(); /* display date and time ? */ 

if(get_key(feline[0])) /* scan code */ 

while(!get_key(&line[l])) /* character code */ 


Serial Communications - Programming Example 9-41 



> 

break; 


case F10: 

for(i =0; i < 3; i++) 

pdd = &devdat[i]; 
device_clo8e(pdd); 
if(pdd->pic ”0) s = 0x08; 
else s = 0x70; 
intr_flag = int_off(); 
iv_rest(s + pdd->ir_bit); 
int_on(intr_flag); 

> 

return; 

} 

> 

> 


/* get pointer to data */ 
/* close device when done */ 
/* base vector for master pic */ 
/* base vector for slave pic */ 
/* no interrupts allowed */ 
/* restore interrupt vectors */ 
/* allow interrupts */ 
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Chapter 10 
Mouse Information 


Introduction 

The VAXmate mouse (part number VSXXX) is a pointing device with three 
input switches. The mouse has two encoders, one for the X axis and one for 
the Y axis. The encoders have a resolution of 200 counts per inch. When 
moved on a flat surface, the mouse monitors the motion relative to its position 
at the beginning of the motion. Thus, the mouse maintains positional data in 
the form of incremental X/Y encoder counts. Figure 10-1 shows the mouse in 
relation to its X/Y axes. 


//’ 

-Y-axis 



Figure 10-1 VAXmate Mouse (Part Number VSXXX) 
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Communication Requirements 

The mouse communicates through an asynchronous serial interface at 4800 
baud. 

Data bytes have the following format: 

• 1 start bit 

• 8 data bits (least significant bit first) 

• 1 parity bit (the mouse transmits odd parity, but ignores receive parity 
errors.) 

• I stop bit 


If a byte is sent to the mouse while the mouse is transmitting, the mouse 
aborts the transmission and processes the new command. If the mouse receives 
a byte between the characters of a multibyte report, the mouse is considered to 
be transmitting and aborts the report. 

The VAXmate workstation communicates with the mouse through an 
asynchronous serial interface (Signetics SCN2661 Enhanced Programmable 
Communications Interface). 


Additional Source of Information 

The Signetics’ document, Microprocessor Data Manual 1986, provides addi¬ 
tional information on the SCN2661. 


Mouse Commands 

The Table 10-1 lists the mouse commands. The commands are issued by 
transmitting the appropriate command code. 


Table 10-1 Mouse Command Summary 


ASCII 

HEX 

Function 

D 

44H 

Prompt Mode 

R 

52H 

Incremental Stream Mode 

P 

50H 

Request Mouse Position 

T 

54H 

Invoke Self-test 

Zx 

5AH xx 

Vendor Reserved function 
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Prompt Mode 
Incremental Stream Mode 

The mouse has two operating modes, prompt mode and incremental stream 
mode. In prompt mode, which is the powerup default, the mouse generates a 
report in response to a request mouse position command. In incremental 
stream mode, whenever the mouse moves it generates a report of that move¬ 
ment. It also reports a change in button position since the last report. No 
report is generated when the mouse is motionless and no buttons have been 
changed. 

Request Mouse Position 

The mouse responds to this command by sending a position report and switch¬ 
ing to prompt mode. 

Invoke Self-Test 

The mouse responds to this command by executing a self-test and then sending 
a self-test report. Self-test leaves the mouse in the reset or powerup state. 
During the self-test, any data sent to the mouse is ignored until the last byte 
of the self-test report has been sent by the mouse. The 4-byte self-test report 
consists of a 2-byte identification code and a 2-byte status code. 

Vendor Reserved Function 

The vendor reserved function is a 2-byte command, the ASCII character ’Z’ 
followed by any printable character. This command allows vendors to add spe¬ 
cial mouse functions. Normally, these functions are for quality control. The 
manufacturer determines these functions, which may include transmitting spe¬ 
cialized reports. These commands may not include new modes. On completion 
of a vendor reserved function, the mouse must be restored to its previous state. 
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Mouse Reports 

The mouse can transmit two reports, a 3-byte position report and a 4-byte self¬ 
test report. 

Position Report - Byte 1 

76543210 





SIGN-X 

SIGN-Y 

LEFT 

MIDDLE 

RIGHT 






BUTTON 

BUTTON 

BUTTON 

1 

0 

0 







Bit 

Description 

7 

Always 1 

6-5 

Always 0 

4 

SIGN-X (Sign bit for X-axis displacement) 

0 = Negative X-axis displacement 

1 = Positive X-axis displacement 

3 

SIGN-Y (Sign bit for Y-axis displacement) 

0 = Negative Y-axis displacement 

1 = Positive Y-axis displacement 

2 

LEFT BUTTON 

0 = Switch open 

1 = Switch closed 

1 

MIDDLE BUTTON 

0 = Switch open 

1 = Switch closed 

0 

RIGHT BUTTON 

0 = Switch open 

1 = Switch closed 
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Position Report - Byte 2 

76543210 


0 


X-AXIS DISPLACEMENT 


Bit Description 

7 Always 0 

6-0 X-AXIS DISPLACEMENT 

The X-axis displacement is measured in encoder counts (200 per 
inch). The value returned in this byte is the distance moved since 
the last report. In prompt mode, if reports are not requested often 
enough, this value can overflow. If an overflow occurs, no indication 
is given. Bit 0 is the least significant bit. 


Position Report - Byte 3 

7 6 5 4 3 2 

1 0 

0 

i i i i r 

Y-AXIS DISPLACEMENT 

1 i 1 l l 

1 

1 

Bit 

Description 



7 Always 0 

6-0 Y-AXIS DISPLACEMENT 


The Y-axis displacement is measured in encoder counts (200 per 
inch). The value returned in this byte is the distance moved since 
the last report. In prompt mode, if reports are not requested often 
enough, this value can overflow. If an overflow occurs, no indication 
is given. Bit 0 is the least significant bit. 
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Self-Test Report - Byte 1 


7 

6 5 

4 

3 2 1 


0 

FRAME 

1 

i i 

SYNCHRONIZATION 

0 1 
l l 


REVISION NUMBER 

1_1__1_ 

_i. 



Bit Description 


7-5 FRAME SYNCHRONIZATION 

These bits are always 101. They provide a means of detecting the 
first byte of a self-test report. 

4-0 REVISION NUMBER 


This is a hardware and software revision number for this design 
cycle. 


Self-Test Report - Byte 2 

7 6 5 4 

3 

2 1 

0 


i i 

MANUFACTURERS ID 


DEVICE CODE 


0 

1 1 

0 

0 1 
l l l 

0 

Bit 

Description 




7 

6-4 

3-0 

Always 0 

MANUFACTURERS ID 

DEVICE CODE 

Always 0010 
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Self-Test Report - Byte 3 

76543210 



-1-1-1-1 l-1- 

ERROR CODE 

0 

1 1 1 I I 1 

Bit 

Description 

7 

Always 0 

6-0 

ERROR CODE 

00H = No error 

3EH = RAM or ROM checksum error 

3DH = Button error 


Self-Test Report - Byte 4 

76543210 







LEFT 

MIDDLE 

RIGHT 






BUTTON 

BUTTON 

BUTTON 

0 

0 

0 

0 

0 





Bit Description 


7-3 Always 0 

2 LEFT BUTTON 

0 = Switch good 
1 = Switch closed or failed 

1 MIDDLE BUTTON 

0 = Switch good 
1 = Switch closed or failed 

0 RIGHT BUTTON 

0 = Switch good 
1 = Switch closed or failed 
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Serial Interface 

The serial interface is a SIGNETICS SCN2661 Enhanced Programmable 
Communications Interface. Table 10-2 lists the input/output (I/O) ports that 
access the serial interface registers. 


Table 10-2 Serial Interface Registers 


Address 

R/W 

Register 

0C40H 

R 

Receive buffer 


W 

Transmit holding register 

0C41H 

R 

Status register 


W 

Synl/Syn2/DLE registers * 

0C42H 

R/W 

Mode register 1 and mode register 2 ** 

0C43H 

R/W 

Command register 


* The Synl, Syn2, and DLE registers are not used. 

** Mode registers 1 and 2 are accessed at the same I/O address. Read 
mode register 1 and then read mode register 2, or write mode register 
1 and then write mode register 2. Mode register 1 must be accessed to 
access mode register 2. 


Transmit Holding Register and Receive Buffer (0C40H) 

76543210 



-r 

i 

1-1-1-1-1- 

TRANSMIT OR RECEIVE DATA 

1 1 1 1 1 

-1 

1 

Bit 

R/W 

Description 


7-0 

R 

Accesses the receive data buffer 



W 

Accesses the transmit holding register 
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Status Register (0C41H) 


7 

6 

5 

4 

3 

2 

1 

0 

DATA 

SET 

READY 

1 

DATA 

CARRIER 

DETECT 

1 

FRAMING 

ERROR 

OVERRUN 

PARITY 

ERROR 

DATA 

SET 

READY 

CHANGED 

RxRDY 

TxRDY 


Bit 

R/W 

Description 

7 

R 

DATA SET READY (always 1) 

6 

R 

DATA CARRIER DETECT (always 1) 

5 

R 

FRAMING ERROR 

0 = Normal 

1 = Framing error 



This bit is cleared by disabling the receiver, issuing the reset error 
command, or reading the status register. 

4 

R 

OVERRUN 

0 = Normal 

1 = Overrun error 



This bit is cleared by disabling the receiver or issuing the reset 
error command. 

3 

R 

PARITY ERROR 

0 = Normal 

1 = Parity error (if parity checking is enabled) 



This bit is cleared by disabling the receiver, issuing the reset error 
command, or receiving another character. 

2 

R 

DATA SET READY CHANGED (always 0) 

1 

R 

RxRDY - Receive Data Ready 

0 = Receive buffer is empty 

1 = Receive buffer contains data and an interrupt is pending 

0 

R 

This bit is cleared by reading the receive buffer or disabling 
the receiver (command register bit 2). 

TxRDY - Transmit Holding Register Ready 

0 = Transmit holding register busy 

1 = Transmit holding register empty and an interrupt is pending 



This bit is cleared by writing the transmit holding register or dis¬ 
abling the transmitter (command register bit 0). 
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3 


2 


1 


0 


Mode Register 1 (0C42H) 

7 6 5 4 


STOP BITS 

PARITY 

PARITY 

CHARACTER 

l 

MODE AND BAUD 

_1_ 

TYPE 

CONTROL 

LENGTH 

_1_ 

RATE FACTOR 


Bit R/W Description 


7-6 

R/W 

STOP BITS 



00 = 

Invalid 



01 = 

1 stop bit 



10 = 

1-1/2 stop bits 



11 = 

2 stop bits 

5 

R/W 

PARITY TYPE 



0 = 

Odd parity 



1 = 

Even parity 

4 

R/W 

PARITY CONTROL 



0 = 

Parity checking disabled 



1 = 

Parity checking enabled 

3-2 

R/W 

CHARACTER LENGTH 



00 = 

5 bits 



01 = 

6 bits 



10 = 

7 bits 



11 = 

8 bits 

1-0 

R/W 

MODE AND BAUD RATE FACTOR 



00 = 

Synchronous 1 X rate 



01 = 

Asynchronous 1 X rate 



10 = 

Asynchronous 16 X rate 



11 = 

Asynchronous 64 X rate 


Mode registers 1 and 2 are accessed at the same I/O address. Read mode regis¬ 
ter 1 and then read mode register 2, or write mode register 1 and then write 
mode register 2. Mode register 1 must be accessed to access mode register 2. 

When programming mode register 1 on the VAXmate workstation, use a value 
5EH. 
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Mode Register 2 (0C42H) 


7 

6 5 

4 

3 

2 

i 

0 

0 

i i i 

RECEIVE AND TRANSMIT 
CLOCK SOURCE 

1 1 

1 1 1 

1 

.. 1 

1 

BAUD 

1 1 

t 

RATE 

I 


Bit 

Description 







7-4 RECEIVE AND TRANSMIT CLOCK SOURCE 

For the VAXmate workstation hardware, this value is fixed. 

3-0 BAUD RATE 

See Table 10-3 


Mode registers 1 and 2 are accessed at the same I/O address. Read mode regis¬ 
ter 1 and then read mode register 2, or write mode register 1 and then write 
mode register 2. Mode register 1 must be accessed to access mode register 2. 

When programming mode register 2 on the VAXmate workstation, use a value 
7CH. 

Table 10-3 Baud Rate Table 


Bits 

3-0 

Baud 

Rate 

Bits 

3-0 

Baud 

Rate 

0000 

50 


1800 

0001 

75 


2000 

0010 

110 

1010 

2400 

0011 

134.5 


3600 

0100 

150 


4800 

0101 

300 


7200 

0110 

600 

1110 

9600 

0111 

1200 

1111 

19200 
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Command Register (0C43H) 


7 6 

5 

4 

3 

2 

1 

0 

1 

OPERATING NODE 

REQUEST 

RESET 

SYNCH/ 

RECEIVE 

DTR 

XMIT 

_1_ 

TO SEND 

ERROR 

ASYNCH 

CONTROL 


CONTROL 


Bit R/W Description 


7-6 R/W OPERATING MODE 

00 = Normal operation 

01 = Asynchronous (automatic echo mode) 

10 = Local loop back 

11 = Remote loop back 

5 R/W REQUEST TO SEND 

0 = Force request to send output high (disables interrupt buffer) 
1 = Force request to send output low (enables interrupt buffer) 

The 2661 EPCI has a buffer 

between the interrupt output line and the peripheral interrupt con¬ 
troller input. This buffer is controlled by bit 3. Enabling the buffer 
enables the 2661 EPCI interrupt output line. 

4 RESET ERROR 


3 


2 


1 


0 


R Always 0 

W 0 = No effect 

1 = Reset error flags (parity, framing, overrun) 

R/W SYNCH/ASYNCH 
0 = Normal 
1 = Force break 

R/W RECEIVE CONTROL 

0 = Disable receiver, receive interrupt, and status register bit 1 
1 = Enable receiver, receive interrupt, and status register bit 0 

R/W DTR - Data Terminal Ready (output not connected) 

0 = Force data terminal ready output high 
1 = Force data terminal ready output low 

R/W XMIT CONTROL - Transmit Control 

0 = Disable transmitter, transmit interrupt, and status register 
bit 0 

1 = Enable transmitter, transmit interrupt, and status register 
bit 0 


When programming the command register on the VAXmate workstation, use a 
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base value of 30H. In addition to the base value, bits 0 and 3 (transmit and 
receive control) must be applied as required. 
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Programming Example 

The mouse programming example demonstrates: 

• Communicating with the mouse 

• Interpreting the motion 

• Interpreting the buttons 

• Scaling the mouse motion to the screen 


The example provides routines as described in the following list: 


mouseinit 

mouseopen 

send_to_mouse 

mouse_int 

mouse_close 

mouse 


Initializes the SCN2661 serial interface. 

Prepares the serial interface for interrupt driven 
communications. 

Sends commands to the mouse. 

Is the serial interface interrupt handler. 

Deactivates the serial interface. 

Executes the example program. 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The include file rb.h defines the ring buffer structure used in the serial inter¬ 
face interrupt handler. The include files kyb.h and example.h support the exam¬ 
ple, but are not pertinent to the mouse section. 

The constant value MOUSE_PORT defines the base address of the serial inter¬ 
face. The constant values MOUSE_PIC through MOUSE_HWI define the in¬ 
terrupt controller, interrupt input line, and the interrupt vector for the serial 
interface. 

The constant values MMODE through CMND_REG define bit values for the 
serial interface registers. The constant values SELF TEST through POS_REP 
define the mouse command bytes. Finally, the constant values TESTMASK 
through BUTTON_ERR define various values used in deciphering the mouse 
reports. 
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#include "rb.h" 

#include "kyb.h" 
#include "example.h 1 


/* define constant values used in example mouse driver */ 


#define M0USE_P0RT (MOUSEJJART *) 0x0C40 
#define MOUSE_PIC 1 
#define M0USE_INT 4 
#define MOUSE.HWI 0x74 


/* SCN2661 mode 

register bit values */ 

#define 

MMODE 

0x02 

#define 

P_ENAB 

0x10 

#define 

P_EVEN 

0x20 

#define 

P.ODD 

0x00 

#define 

W0RD8 

OxOC 

#define 

W0RD7 

0x08 

#define 

W0RD6 

0x04 

#define 

W0RD5 

0x00 

#define 

S.BITl 

0x40 

#define 

S_BIT2 

OxCO 

#define 

BD4800 

OxOC 

#define 

CLKSPC 

0x70 


/* base address of mouse */ 
/* PIC that handles mouse */ 
/* mouse int request line */ 
/* harware int vector location */ 


/* Aynchronous 16X rate */ 
/* Enable parity */ 
/* Even parity select */ 
/* Odd parity select */ 
/* 8 bit characters */ 

/* 7 bit characters */ 

/* 6 bit characters */ 

/* 5 bit characters */ 

/* One stop bit */ 
/* Two stop bits */ 
/* 4800 baud */ 
/* 16X clock */ 


/* SCN2661 status register bit masks 

#define THRE 0x01 / 

#define RDRDY 0x02 

#define ERRORS 0x38 

#define PARITYERR 0x08 

#define OVERRUNERR 0x10 

#define FRAMINGERR 0x20 


*/ 

Transmit holding register is empty */ 
/* Receive holding register is full */ 
/* Parity, overrun or framing error */ 
/* Parity error */ 
/* Overrun error */ 
/* Framing error */ 


Mouse Information - Programming Example 


10- 15 



/* SCN2661 command register bit values */ 


#define TxEN 0x01 
#define DTR 0x02 
#define RxEN 0x04 
#define BREAK 0x08 
#define RESET 0x10 
#define RTS 0x20 

#define CMODE OxCO 
#define CMND_REG RTS|RESET|RxEN /* 

/* Define mouse commands */ 

#define SELF_TEST *T* 

#define P.MODE *D’ 

#define I_S_M0DE *R’ 

#define P0S_REP ’P’ 


/* Enable transmit control */ 
/* Disable data terminal ready */ 
/* Enable receive control */ 
/* Disable break */ 
/* Enable reset status */ 
/* RTS (normally on) */ 
/* Command mode (normally 0) */ 
normal operation, RTS - !, rec enabled */ 


/* self-test command */ 
/* prompt mode */ 
/* incremental stream mode */ 
/* request position report */ 


/* These values are used to check the mouse */ 


#define TESTMASK OxeO 
#define HEADER.BYTE 0x80 
#define SELFTEST OxaO 
#define POSREP 0x80 
#define RIGHTBUTTON 0x01 
#define MIDDLEBUTTON 0x02 
#define LEFTBUTTON 0x04 
#define XSIGN 0x10 
#define YSIGN 0x08 
#define ROMRAMJERR 0x3e 
#define BUTTON_ERR 0x3d 


/* mask any header byte */ 
/* header byte indicator */ 
/* self-test header byte mask */ 
/* position report header byte mask */ 
/* right button mask */ 

/* left button mask */ 

/* middle button mask */ 

/* X-axis sign bit mask */ 
/* Y-axis sign bit mask */ 
/* self-test byte # 2 error type mask */ 

/* self-test byte # 2 error type mask */ 
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/**********************Jtc************************************************/ 

/* define structures used in example mouse driver */ 

typedef struct 

{ 

unsigned char hr; 
unsigned char status; 
unsigned char mode; 
unsigned char command; 

> MOUSE.UART; 

typedef struct mouse_dat 

{ 

MOUSE_UART *base; 

RING.BUFF *prbi; 

RING_BUFF *prbo; 

> M0USE.DAT; 

/* reserve storage for variables used in example mouse driver */ 

#define BUF.SIZ 100 /* size of buffers */ 

#define HIWATER 75 /* buffer near full value */ 

#define LGWATER 25 /* buffer near empty value */ 

RINGJBUFF rb[2]; /* ring buff Ctrl structs */ 

char buff[2][BUF_SIZ]; /* ring buffers */ 

unsigned char cmnd_reg; /* value to write to command register */ 

M0USE_DAT mouse.data = { M0USE_P0RT, &rb[0], &rb[l] >; 

int quietmouse = OFF; /* mouse state flag */ 


/* base i/o address of device */ 
/* pointer to input ring buffer structure */ 
/* pointer to output ring buffer structure */ 


/* transmit/receive holding register */ 
/* status register */ 
/* mode register */ 
/* command register */ 
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/ * * * * * * * :|e * * * * * * * * * * * * * * * ale * * * * * * * * * * * * 4c * * * * * * * * * * * * * 4c * * * * * * * He * * * * * * * * * * * * / 

/* mouBe_init() - establish a known state for the mouse and SCN2661 */ 

/**********************************^************************************/ 


void mouse_init() /* initialize mouse and port */ 

{ 


register MOUSE_DAT *pdd; 
register MOUSE_UART *ps; 


/* pointer to mouse data */ 
/* pointer to mouse struct */ 


pdd = &mouse_data; /* point to driver data */ 

ps » pdd->base; /* assign base address */ 


/* initialize ring buffer structures */ 

init_rb(pdd->prbi, &buff[0][0], BUF_SIZ, HIWATER, LOWATER); 
init_rb(pdd->prbo, Abuff [1] [0] , BUF_SIZ, HIWATER, LOWATER); 

/* async 16x, enable parity, odd parity, eightbit data, one stop bit */ 
outp(Aps->mode, MMODE | PJENAB | P_0DD | W0RD8 | S_BIT1); 
outp(Aps->mode, BD4800 | CLKSPC); /* 16x clock, 4800 baud */ 

cmnd_reg = CMND_REG; /* init to normal contents */ 

outp(Aps“>command, cmnd__reg) ; /* reset status errors */ 


NOTE 

During the initialization process, it is possible to transmit or re¬ 
ceive garbage characters. The mouse initialization function does 
not account for this possibility. 

/* mouse_open() - activate mouse interrupts */ 

/He**********************************************************************/ 

void mouse_open() /* open the mouse */ 

imask(MOUSE_PIC, M0USE_INT, ON); /* enable interrupt input */ 

> 


10- 18 


Mouse Information - Programming Example 



/* send_to_mouse() - write data to mouse */ 


send_to_mouse(c) 

unsigned char c; /* byte value to transmit */ 


{ 

register MOUSE_DAT *pdd; 
register MOUSE_UART *ps; 
int intr_flg; 

pdd = &mouse_data; 
ps = pdd->base; 

while(rb_in(pdd->prbo, c) < 0 ) 
* 

intr_flg = int_off(); 
cmnd.reg 1= TxEN; 
outp(Aps->command, cmnd.reg); 
int_on(intr_flg); 


/* pointer to mouse data */ 
/* pointer to mouse struct */ 
/* hold state of CPU IF */ 

/* point to driver data */ 
/* assign base address */ 
/* wait until stored in buffer */ 

/* disable CPU interrupt */ 
/* to enable transmitter */ 
/* enable transmitter */ 
/* enable CPU interrupt */ 
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/* mouse.int() - interrupt handler for mouse serial port */ 


void mouse_int() /* interrupt handler */ 

register M0USE_DAT *pdd; /* pointer to mouse data */ 

register MOUSE.UART *ps; /* pointer to MOUSE.UART struct */ 

unsigned char c; 
unsigned char s; 


pdd = Amouse.data; 
ps = pdd->base; 

8 = inp(Aps->status); 


/* assign base address */ 
/* read status of port */ 


if(s A (PARITYERR | FRAMINGERR)) /* garbage character ? */ 

8 = inp(ftps->hr); /* read garbage character */ 

else if(s A RDRDY) /* is there anything to read ? */ 

{ /* read and store in ring buffer */ 

if(rb_in(pdd->prbi, inp(Aps->hr)) < 1 ) /* buffer getting full ? */ 


send_to_mouse(P_MODE); 
quietmouse = ON; 


/* put mouse in prompt mode */ 


if(s k THRE) 
i 

if(rb_out(pdd->prbo, Ac) < 0) 
cmnd.reg k= TxEN; 
else outp(Aps->hr, c); 

> 

outp(fcps->command, cmnd^reg); 
eoi(MOUSE^PIC); 


/* ready to transmit ? */ 

/* any characters to transmit ? */ 
/* disable transmitter */ 
/* write the character */ 

/* reset status errors */ 
/* send EOI to interrupt controller */ 


NOTE 

This routine could check for overrun errors, but it does not. 
Because each mouse report has a fixed byte count, missing char¬ 
acters are detected in the record collection part of the mouseO 
function. 


10- 20 Mouse Information - Programming Example 



/* mouse_close() - deactivate mouse port interrupts */ 


void mouse_close() 

{ 

register MOUSE.DAT *pdd; 
register MOUSE_UART *ps; 

pdd = £mouse_data; 
send_to_mouse(P_MODE); 
while(pdd->prbo->count) 

9 

cmnd_reg = CMND.REG k RxEN; 
ps = pdd->base; 
outp(&ps->command, cmnd_reg); 
imask(MOUSE_PIC, MOUSE_INT, OFF); 


/* deactivate the mouse */ 


/* pointer to mouse data */ 
/* pointer to MOUSE_UART struct */ 

/* point to driver data */ 
/* put mouse in prompt mode */ 
/* wait until ring buffer empty */ 

* disable receiver and transmitter */ 
/* assign base address */ 
/* write new command */ 
/* disable interrupt input */ 
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/***********************************************************************/ 
/* example application that uses mouse driver */ 

/%**********************************************************************/ 

mouse () 

{ 


static MESSAGE mmouse[] = /* mouse menu */ 

{ 

{ 3, 34, "Mouse Example" >, 

{ 5, 18, "Move the mouse to see X and Y displacements." >, 

{ 6, 16, "Move cursor to a box and select with left button." >, 

{ 8, 24, "[ ] End Mouse Example" >, 

{ 9, 24, "[ ] Increase X Scale" }, 

{ 10, 24, "[ ] Decrease X Scale" >, 

{ 11, 24, "[ ] Increase Y Scale" >, 

{ 12, 24, "[ ] Decrease Y Scale" >, 

{ 14, 24, "Left button status: Up " >, 

{ 15, 24, "Middle button status: Up " >, 

{ 16, 24, "Right button status: Up " >, 

{ 18, 24, "X encoder counts: 0" >, 

{ 19, 24, "Y encoder counts: 0" >, 

{ 20, 24, "X Scale: 12" }, 

{21, 24, "Y Scale: 52" >, 

{ 0 , 0 , 0 >, 

>; 

register M0USE_DAT *pdd; /* pointer to mouse data */ 

register MOUSE.UART *ps; 


unsigned char i_buff[80]; 
char o_buff[80]; 
char kb; 

unsigned char *pb; 
int row = 0; 
int tmp; 

int pos_rep = 0; 

int end_me = FALSE; 

int left_button = FALSE; 

int buff_state; 

int x_abs = 40; 

int y_abs = 12; 

int x_cnt8 = 0; 

int y_cnts = 0; 

int x^scale = 12; 

int y.scale = 52; 


/* input buffer */ 

/* output buffer */ 

/* pointer to input buffer */ 

/* row position of cursor or text */ 
/* temporary variable */ 
/* mouse position report flag */ 
/* end mouse example flag */ 
/* state of left button */ 
/* input buffer state flag */ 
/* absolute position of cursor in X-axis */ 

/* absolute position of cursor in Y-axis */ 

/* accumulated X-axis encoder counts */ 
/* accumulated Y-axis encoder counts */ 
/* encoder counts per column */ 
/* encoder counts per row */ 


int moved = 0; 


/* flag to indicate that mouse reported motion */ 
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int intr_ fig; 
int cnt_req; 


/* hold state of CPU IF */ 
/* byte count required for report */ 


extern int time_flag; 


/* defined in RTC example */ 


pdd = &mouse_data; 
ps » pdd->base; 
intr_flg » int_off(); 
iv_init(MQUSE_HWI); 
mouse_init(); 
int_on(intr_flg); 
mouse_open(); 
send_to__mouse(P_MODE) ; 


/* get pointer to data */ 
/* assign base address ♦/ 
/* disable CPU interrupt */ 
/* init interrupt vectors */ 
/* init mouse */ 
/* enable CPU interrupt */ 
/* activate mouse */ 
/* ensure mouse is in prompt mode */ 


while(rb_out(pdd->prbi, Ai_buff[0]) >* 0) /* while buffer not empty */ 

; /* dump characters */ 

send_to_mouse(SELF_TEST); /* issue self-test command */ 

intr_flg * int_off(); /* disable CPU interrupt */ 

time_flag * 0; /* reset RTC second flag */ 

int_on(intr_flg); /* enable CPU interrupt */ 

for(tmp = 0; time_flag < 3 kk tmp < 4; ) 

if(rb_out(pdd->prbi, lci_buff[tmp]) >= 0) /* try to read character */ 

{ 

if((i_buff[tmp] k TESTMASK) — SELFTEST)/* self-test header byte */ 
tmp =1; /* first byte of report */ 

else if(tmp) tmp++; /* additional report bytes */ 

> 

> 

tmp = 0; 

if(time_flag >= 3) /* check for time-out error */ 

strcpy(&o_buff[0], "Mouse time-out error"); /* error message */ 

tmp =1; /* set error indicator */ 

> 

else if(i_buff[2] == 0x3e) /* check for mouse ROM/RAM error */ 

{ 

strcpy(&o_buff[0], " Mouse ROM/RAM error"); /* error message */ 

tmp =1; /* set error indicator */ 

> 

else if(i_buff[2] == 0x3d) /* check for mouse button errors */ 

strcpy(&o_buff[0], " Mouse button error"); /* error message */ 

tmp =1; /* set error indicator */ 

> 

if(tmp) /* test error indicator */ 

clear_vid_mem(); 
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disp_str(12, 35, fto_buff[0]); /* show error message */ 
disp_str(13, 35, "Press F10 to continue”); /* show help message */ 
while(1) if(get.key(Akb) -■ 1 kk kb F10) break; 


> 

else 

disp.menu(mmouse) ; 
cursor.on(y.abs, x.abs); 
send_to.mouse(I.S_MODE) ; 
cnt_req = -1; 
pos.rep = FALSE; 
pb = Ai.buff[0]; 
while(end.me == FALSE) 

chk.dt(); 


/* display the mouse menu */ 
/* make cursor visible */ 
/* reset to incremental stream mode */ 
/* set byte count required to below zero */ 
/* no position report yet */ 
/* initialize pointer to input buffer */ 


/* check date and time for update */ 
buff.state = rb.out(pdd->prbi, pb); /* try to read mouse */ 
if(buff.state >■ 0) /* did the mouse send anything ? */ 

if(*pb k HEADER.BYTE) /* is it a header byte ? */ 

i 

i.buff[0] = *pb; /* move to beginning of buffer */ 
pb = &i.buff[l]; /* reset to next byte in input buffer */ 
if((i.buff[0] k TESTMASK) — POSREP) /* discover header type */ 

/* remaining count required */ 
/* have header byte for position report */ 


cnt.req = 2; 
pos.rep = TRUE; 

> 

else 

cnt.req = -1; 
pos.rep = FALSE; 

> 


/* anthing else is an error */ 

/* set byte count required to below zero */ 
/* no position report */ 


else if(pos.rep) /* if received a position report header byte */ 

{ 

if(++pb > &i.buff[10]) /* increment buffer pointer */ 

{ /* if pointer test is true, unexpected error condition */ 

pb = &i_buff[0]; /* reset buffer pointer */ 

pos.rep = FALSE; /* cannot be a position report */ 

cnt.req - -1; /* set byte count required to below zero */ 

> 

if(—cnt.req == 0) /* end of report ? */ 

/* get position increments */ 


moved = 0; 
tmp = i.buff[1]; 


/* clear mouse motion flag */ 
/* get X-axis increment */ 
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if(!(i_buff[0] k XSIGN)) tmp = -tmp; /* check sign bit */ 
x_cnts += tmp; /* accumulate X-axis encoder counts */ 

sprintf (o_buf f, "%4d", tmp); /* convert to a string */ 

disp_str(18, 42, o_buff); /* show X-axis increment */ 

tmp = x_cnts / x_8cale; /* enough to show motion ? */ 

if(tmp) 

x_cnts -= x_scale * tmp; /* remove scaled counts */ 

x_abs += tmp; /* add to absolute position */ 

if(x_abs < 0) x_abs =0; /* no off-screen motion */ 

if(x_abs > 79) x_abs =79; /* no off-screen motion */ 

moved =1; /* set flag to update cursor position */ 

> 

tmp = i_buff[2]; /* get Y-axis increment */ 

if(!(i_buff[0] k YSIGN)) tmp = -tmp; /* check sign bit */ 

/* y-axis encoder counts are accumulated negatively to invert motion */ 

y_cnts -= tmp; /* accumulate Y-axis encoder counts */ 

sprintf (o_buff, ,,# /.4d H , tmp); /* convert to a string */ 

di8p_8tr(19, 42, o_buff); /* show Y-axis increment */ 

tmp = y_cnt8 / y_scale; /* enough to show motion ? */ 

if(tmp) 

y.cnts -= y_scale * tmp; /* remove scaled counts */ 

y__abs += tmp; /* add to absolute position */ 

if(y_abs < 0) y_abs =0; /* no off-screen motion */ 

if(y_abs > 24) y_abs =24; /* no off-screen motion */ 

moved =1; /* set flag to update cursor position */ 

> 

if(moved) mv_cursor(y_abs, x_abs); /* update cursor */ 

/* display state of mouse buttons */ 

for(tmp = LEFTBUTTON, row = 14; row < 17; row++, tmp »= 1) 

{ 

if(i_buff[0] k tmp) disp_str(row, 46, "Down”); 
else diBp__str(row, 46, "Up ") ; 

> 

if(i_buff[0] k LEFTBUTTON) /* test for valid selection */ 

i 

if(!left_button) /* must release button from last select */ 

left_button = TRUE; /* left button pressed */ 

if(x_abs == 25) 

{ 

switch(y_abs) 

case 8: /* end mouse example */ 


Mouse Information - Programming Example 10- 25 



end.me - TRUE; /* set to true */ 

break; 


case 9: 

if(x.scale < 1000) 
x.scale += 2; 
break; 


/* increase X scale */ 
/* arbitrary value */ 
/* arbitrary increment */ 


case 10: 

if(x_8cale > 2) 
x_scale -= 2; 
break; 


/* decrease X scale */ 
/* cannot be zero */ 
/* arbitrary decrement */ 


case 11: 

if(y.scale < 1000) 
y.scale +* 2; 
break; 


/* increase Y scale */ 
/* arbitrary value */ 
/* arbitrary increment */ 


case 12: 

if(y.scale > 2) 
y_scale -= 2; 
break; 

> 

sprintf(o.buff, ,,# /.3d M , x.scale) ; /* convert */ 

disp_str(20, 33, o.buff); /* show new X-scale */ 

sprintf(o.buff, M %3d", y.scale); /* convert */ 

disp_str(21, 33, o.buff); /* show new Y-scale */ 

> 

> 

> 

else left.button * FALSE; /* reset left button state */ 

pos.rep = FALSE; /* no position report */ 

> 

> 

> 

/* If mouse disabled because the ring buffer was full, turn it back on */ 
if(quietmouse Aft buff.state -* 0) send_to_mouse(I_S_MODE); 

> 


/* decrease Y scale */ 
/* cannot be zero */ 
/* arbitrary decrement */ 


} 

mouse.close(); 
intr.flg = int.offO; 
iv.rest(MOUSE.HWI); 
int_on(intr_flg); 


/* close the mouse */ 
/* no interrupts allowed */ 
/* restore old vectors */ 
/* allow interrupts */ 
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Chapter 11 
Diskette Drive Controller 


Introduction 

The diskette drive controller interfaces the VAXmate system bus and the 
diskette drives. The diskette drive controller supports the following drives and 
media: 

Drive Type Media 

5 Vi Inch - High capacity 1.2 Megabyte - 80 Track - High capacity 

800 Kbyte - 80 Track - Standard 

360 Kbyte - 40 Track - Standard (with 
double stepping) 


The diskette drive controller operates in either DMA or non-DMA mode. In 
DMA mode, the processor initializes the DMA controller and issues the 
transfer command to the diskette controller. The diskette controller and the 
DMA controller transfer the data unattended. In non-DMA mode, the diskette 
controller generates interrupts to the processor each time the controller 
transfers a data byte. 
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Diskette Drive Controller Registers 


The diskette drive controller has five 8-bit registers that are accessed through 
four port addresses. Table 11-1 lists the registers. 

Table 11-1: Diskette Drive Controller Registers 


Address 

R/W 

Register 

03F2H 

W 

Control register 

03F4H 

R 

Main status register 

03F5H 

R/W 

Data register 

03F6H 

W 

Transfer rate register 

03F6H 

R 

Change register 
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3 


2 


1 


0 


Control Register (03F2H) 

7 6 5 4 



MOTOR B MOTOR A DMA RESET 
ENABLE 



DRIVE 

SELECT 


Bit R/W Description 

7-6 W Always 0 

5 W MOTOR B 

0 = Drive B motor off and disable bit 0 
1 = Drive B motor on and enable bit 0 

4 W MOTOR A 

0 = Drive A motor off and disable bit 0 
1 = Drive A motor on and enable bit 0 

3 W DMA ENABLE 

0 = Disable the diskette drive controllers DMA request, DMA ac¬ 
knowledge, and interrupt request 

1 = Enable the diskette drive controllers DMA request, DMA ac¬ 
knowledge, and interrupt request 

2 W RESET 

0 = Reset the diskette drive controller 

1 = Enable the diskette drive controller 

1 W Always 0 

0 W DRIVE SELECT 

0 = Select Drive A 

1 = Select Drive B 

This bit is enabled or disabled by bits 5-4. 


Diskette Drive Controller - Hardware Description 11-3 













Main Status Register (03F4H) 


7 

6 

5 

4 

3 

2 

1 

0 

REQUEST 

FOR 

DATA 

I/O 

NON-DMA 

CONTROL 

DRIVE 3 

DRIVE 2 

DRIVE 1 

DRIVE 0 

RASTER 


MODE 

BUSY 

BUSY 

BUSY 

BUSY 

BUSY 


Bit 

R/W 

Description 

7 

R 

REQUEST FOR MASTER 

0 = Data register not ready 

1 = Data register is ready to be read or written by processor 

6 

R 

DATA I/O DIR - Data I/O Direction 

0 = Transfer data from processor to data register 

1 = Transfer data from data register to processor 

5 

R 

NON-DMA MODE 

0 = Result phase (execution phase ended) 

1 = Execution phase 

4 

R 

CONTROL BUSY 

0 = Controller ready to accept new command 

1 = Controller processing a read or write command 

3 

R 

DRIVE 3 BUSY 

0 = Drive 3 not seeking 

1 = Drive 3 seeking new track 

2 

R 

DRIVE 2 BUSY 

0 = Drive 2 not seeking 

1 = Drive 2 seeking new track 

1 

R 

DRIVE 1 BUSY 

0 = Drive 1 not seeking 

1 = Drive 1 seeking new track 

0 

R 

DRIVE 0 BUSY 

0 = Drive 0 not seeking 

1 = Drive 0 seeking new track 
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Data Register (03F5H) 



7 

6 5 

4 3 

2 

1 


0 


1 

1 

i i t 

STATUS OR DATA 



1 



1 

1 

1 1 1 

1 

1 

1 


Bit 

R/W 

Description 






7-0 

R/W 

Status or data 







This register accesses several internal diskette drive controller registers. The 
internal register accessed depends on the state of the diskette drive controller. 
The internal registers and the diskette drive controller states are discussed 
later in this chapter in the section Diskette Drive Controller Programming. 
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2 


1 


0 


Data Transfer Rate Register (03F6H) 

7 6 5 4 3 








-1- 

TRANSFER RATE 

0 

0 

0 

0 

0 

0 

_1_ 


Bit R/W Description 

7-2 W Always 0 

1-0 W TRANSFER RATE 

00 = 500 KBits per second 

01 = 250 KBits per second * 

10 = 250 KBits per second 

11 = Not used (selects 250 KBits per second) 

* The industry-standard transfer rate for the bit values (01) is 300 KBits 
per second. 

On power-up, this register defaults to 250 KBits per second. 


Change Register (03F6H) 

76543210 


CHANGE 

STATUS 

0 

0 

0 

0 

0 

0 

0 


Bit R/W Description 
7 R CHANGE STATUS 

0 = Since the last time this register was read, the diskette in the 
selected drive has not been removed. 

1 = Since the last time this register was read, the diskette in the 
selected drive was removed. 

6-0 R Always 0 
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Diskette Drive Controller Internal Registers 

The diskette drive controller has several internal registers that are read or 
written through the data register as a series of command or status bytes. The 
usage of these registers is dependent on the command. Tables 11-3 through 
11-17 define the command specific usage. 

Internal Register - Command 


7 

6 

5 

4 

3 2 1 

0 

MT 

MFM 

SK 

1 

1 

i -1-1 i 

COMMAND SELECT 

1 _1_1_ 1 

1 

1 


Bits E/W Description 


7 W 


6 W 


5 W 


4-0 W 


MT - Multi-track (Must be 0 for some commands) 

0 = Disable multi-track 

1 = Enable multi-track (Accessing both sides of the diskette 
automatically) 

MFM - Modified Frequency Modulation 

0 = Use FM (Frequency Modulation) for reading and writing the 
diskette 

1 = Use MFM for reading and writing the diskette 

SK - Skip (Must be 0 for some commands) 

0 = Do not skip sectors containing a DELETED DATA 
ADDRESS MARK 

1 = Skip sectors containing a DELETED DATA ADDRESS 
MARK 


COMMAND SELECT 

00010 = Read Track 

00011 = Specify 

00100 = Sense Drive Status 

00101 = Write Data 

00110 = Read Data 

00111 = Recalibrate 

01000 = Sense Interrupt Status 

01001 = Write Deleted Data 


01010 = Read ID 
01100 = Read Deleted Data 
01101 = Format Track 
01111 = Seek 
10001 = Scan Equal 
11001 = Scan Low or Equal 
11101 = Scan High or Equal 
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Internal Register - Head/Unit Select 


76543210 



7-3 W Always 0 

2 W HEAD SELECT 

0 = Select head on side 0 

I = Select head on side 1 

1-0 W UNIT SELECT 

00 = Select drive 0 
01 = Select drive 1 
10 = Select drive 2 

II = Select drive 3 

Because the outputs are not connected, these bits are ineffective. 
Use bits 5, 4, and 0 of the control register to select the drive. 
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Internal Register • Status Register 0 


7 6 

5 

4 

3 

2 

1 0 


SEEK 

EC 

NOT 


i 

UNIT SELECT 




READY 

ADDRESS 



■■ 




_1_ 


Bit R/W Description 


7-6 R INTERRUPT CODE 

00 = Command completed successfully 

01 = Command started but did not complete successfully 

10 = Command was never started 

11 = Abnormal termination (disk drive ready signal changed 

state during command execution! 

5 R SEEK END 

0 = Seek not complete 
1 = Seek complete 

4 R EC - Equipment Check 

0 = No error detected 

1 = Fault signal detected or, during a recalibrate, the track 0 
signal was not detected after 77 step pulses 

3 R NOT READY 

0 = Drive was ready 
1 = Drive not ready signal was detected 

2 R HEAD ADDRESS 

0 = Side 0 selected 

I = Side 1 selected 

1-0 R UNIT SELECT 

00 = Drive 0 selected 

01 = Drive 1 selected 

10 = Drive 2 selected 

II = Drive 3 selected 
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Internal Register - Status Register 1 


7 

6 

5 

4 

3 

2 

1 

0 

EN 

0 

DATA 

ERROR 

OVERRUN 

0 

NO DATA 

NV 

MISSING 

ADDRESS 

MARK 


Bit R/W Description 


7 R EN - End of Cylinder 

0 = No error 

1 = Controller attempted to access a sector beyond the last 
sector of a cylinder 

6 R Always 0 

5 R DATA ERROR 

0 = No error 

1 = Controller detected a cyclic redundancy check (CRC) error in 
the ID or data field 

4 R OVERRUN 

0 = No error 

1 = During a data transfer in non-DMA mode, the processor did 
not service the controller within the required time interval 

3 R Always 0 

2 R NO DATA 

0 = No error 

1 = One of the following conditions occurred: 

During execution of a read data, a write-deleted data, or a scan 
command, the controller could not find the specified sector. 

During execution of a read ID command, the controller could not 
read the ID field. 

During execution of a read track command, the starting sector 
could not be found. 
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Bit R/W Description (Status Register 1 - cont.) 


1 R NW - Not Writable 

0 = No error 

1 = During a write data, write-deleted data, or format track com¬ 
mand, the controller detected a write-protect signal from the 
disk drive. 

0 R MISSING ADDRESS MARK 

0 = No error 

1 = One of the following conditions occurred: 

The controller had detected the index hole twice, but had not 
detected the ID field ADDRESS MARK. 

The controller could not detect the DATA ADDRESS MARK 
or the DELETED DATA ADDRESS MARK. When this bit 
is set, status register 2 bit 0 (MD) is set. 
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Internal Register - Status Register 2 

7 6543210 



CONTROL 

DATA 

ERROR 

WC 

0 

NARK 

IN DATA 
FIELD 




SN 



Bit R/W Description 


7 R Always 0 

6 R CONTROL MARK 

0 = DELETED DATA ADDRESS MARK not detected 
1 = During a read data or scan command, the controller found a 
DELETED DATA ADDRESS MARK. 

5 R DATA ERROR IN DATA FIELD 
0 = No error 

1 = Controller detected a cyclic redundancy check (CRC) error in 
the data field. 

4 R WC - Wrong Cylinder 

0 = No error 

1 = Cylinder number in the ID field does not match the cylinder 
number in the internal register 

3 R SCAN EQUAL HIT 

0 = No match 

1 = During the execution of a scan command, the equal condition 
was satisfied. 

2 R SN - Scan Not Satisfied 

0 = No error 

1 = During the execution of a scan command, the controller 
could not find a sector on the cylinder that met the 
condition. 

1 R BC - Bad Cylinder 

0 = No error 

1 = Cylinder number in the ID field is FFH and does not match 
the cylinder number in the internal register 

0 R MD - Missing ADDRESS MARK in Data Field 
0 = No error 

1 = During execution of a read command, the controller could 
not find a DATA ADDRESS MARK or DELETED DATA 
ADDRESS MARK. 
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Internal Register - Status Register 3 

76543210 

FAULT WRITE READY TRACK 0 TWO HEAD UNIT SELECT 

PROTECT SIDE ADDRESS 


Bit R/W Description 

7 R FAULT 

0 = No error 

1 = Diskette drive fault signal detected 

6 R WRITE PROTECT 

0 = Diskette not write protected 
1 = Diskette drive write protect signal detected 

5 R READY 

0 = Drive not ready 
1 = Drive ready 

4 R TRACK 0 

0 = Read/Write heads not over track 0 
1 = Read/Write heads over track 0 

3 R TWO SIDE 

0 = Diskette is single sided 
1 = Diskette is double sided 

2 R HEAD ADDRESS 

0 = Side 0 selected 

I = Side 1 selected 

1-0 R UNIT SELECT 

00 = Drive 0 selected 
01 = Drive 1 selected 
10 = Drive 2 selected 

II = Drive 3 selected 
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Internal Register - SRT/HUT 

76543210 


Bit R/W Description 
7-4 W SRT - Step Rate 


0000 = 

16 ms 

1000 

= 

8 ms 

0001 = 

15 ms 

1001 

= 

7 ms 

0010 = 

14 ms 

1010 

= 

6 ms 

0011 = 

13 ms 

1011 

= 

5 ms 

0100 = 

12 ms 

1100 

= 

4 ms 

0101 = 

11 ms 

1101 

= 

3 ms 

0110 = 

10 ms 

1110 

= 

2 ms 

0111 = 

9 ms 

1111 

= 

1 ms 

HUT - 

Head Unload Time 




0000 = 

0 

1000 

= 

128 ms 

0001 = 

16 ms 

1001 

= 

144 ms 

0010 = 

32 ms 

1010 

= 

160 ms 

0011 = 

48 ms 

1011 

= 

176 ms 

0100 = 

64 ms 

1100 

= 

192 ms 

0101 = 

80 ms 

1101 

= 

208 ms 

0110 = 

96 ms 

1110 

= 

224 ms 

0111 = 

112 ms 

1111 

= 

240 ms 


I I I 

SRT 


i i i 

HUT 
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3 


2 


1 


0 


Internal Register - HLT/ND 

7 6 5 4 


-1- 

- 1 - 

-1-1- 

-1- 

-1- 




HLT 



ND 

_1 

_ 1 _ 

1_l 

_ 1 _ 

1_ 



Bit R/W Description 


7-1 W HLT - Head Load Time 

0000000 = No head load time 

0000001-1111111 = 2 ms to 254 ms in 2 ms steps 

0 W ND - Non-DMA Mode 

0 = DMA mode enabled 
1 = DMA mode disabled 


Internal Register • C 

This 8-bit register specifies the currently selected cylinder/track number. To 
ensure that it is at the correct cylinder/track, the diskette controller compares 
this cylinder/track number to the cylinder/track in the sector header. 

Internal Register - H 

This 8-bit register specifies the currently selected read/write head. To ensure 
that it is on the correct side of the diskette, the diskette controller compares 
this head address to the head address in the sector header. Only 0 and 1 are 
valid values. 


Internal Register - R 

This 8-bit register specifies the desired sector number. 
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Internal Register - N 

This 8-bit register specifies the number of data bytes per sector as follows: 
Value Bytes per Sector 


00H 

128 

01H 

256 

02H 

512 

03H 

1024 

04H 

2048 

05H 

4096 

06H 

8192 


Internal Register - EOT 

This 8-bit register specifies the last sector of a read/write operation. The value 
written to this register is the last desired sector plus 1. 

For example, to read or write one sector (sector number 5), internal register R 
would contain 05H and internal register EOT would contain 06H. To read or 
write five sectors (starting at sector 1), internal register R would contain 01H 
and internal register EOT would contain 06H. 

Internal Register * GPL 

This 8-bit register specifies the gap between sectors. When executing the 
format-track command, use a value of 54H. Otherwise, use a value of 1BH. 
These are the values specified by the ROM BIOS. See Interrupt 13H in 
Chapter 15. 

Internal Register - DTL 

When internal register N contains 00H, this 8-bit register specifies the number 
of bytes to be read from or written into a sector. For this register, the ROM 
BIOS defines a value of FFH. See Interrupt 13H in Chapter 15. 

Internal Register - SC 

For the format-track command, this 8-bit register specifies the number sectors 
per track. 
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Internal Register • D 

For the format-track command, this 8-bit register specifies the value used as a 
fill byte. For this register, the ROM BIOS defines a value of F6H. See 
Interrupt 13H in Chapter 15. 

Internal Register - STP 

For the scan commands, this register specifies contiguous sectors (interleave of 
11 or alternate sectors (interleave of 2). 

Internal Register * PCN 

For the sense-interrupt-status command, this 8-bit register returns the result¬ 
ing present-cylinder number 

Internal Registers - NCN 

For the seek command, this 8-bit register specifies the desired cylinder/track 
number (new cylinder number). 


Diskette Drive Controller • Hardware Description 


11- 17 



Diskette Drive Controller Programming 

The diskette drive controller has three operational states, command, execution, 
and result. The current state is determined by bit 7 (REQUEST FOR 
MASTER) and bit 6 (I/O DIR) of the main status register. If bit 7 is equal to 
0, the diskette drive controller is in the execution state. Otherwise, the diskette 
drive controller is in a command or result state. Bit 6 determines whether the 
diskette drive controller is in the command or result state. If bit 6 is equal to 
0, the diskette drive controller is in the command state. Otherwise, the 
diskette drive controller is in the result state. 

Command State 

The diskette drive controller accepts a series of 1 to 9 command bytes that are 
written to the data register. Each command has a fixed set of data bytes that 
are required to initiate the command. For correct results, the set must not be 
shortened. 

On acceptance of a command, the diskette drive controller enters the execution 
state. If a command is not accepted as a valid command, the diskette drive 
controller sets the internal register, status register 0, equal to 80H. 

The diskette drive controller has fifteen commands. Table 11-2 lists the 
diskette drive controller commands. The commands listed in Table 11-2 are 
described later in this chapter. The four internal status registers, 0-3, are 
described in the section on Diskette Drive Controller Internal Registers. 


11-18 Diskette Drive Controller - Hardware Description 



Table 11-2: Diskette Drive Controller Commands 


Command Description 

Head Data Multi-sector read of sectors with DATA ADDRESS 

MARK in header (at the current track) 

Write Data Multi-sector write at the current track (writes a 

DATA ADDRESS MARK in header) 

Read Deleted Data Multi-sector read at the current track (including those 

with a DELETED DATA ADDRESS MARK in 
header) 

Write Deleted Data Multi-sector write at the current track (writes a 

DELETED DATA ADDRESS MARK) 

Read Track Read all sectors at the current track 

Read ID Reads the ID field of the first sector encountered at 

the current track 

Format Track Formats sectors in the track as indicated 

Scan Equal Data on the diskette is compared for equality to data 

in memory (8-bit data) 

Scan Low or Equal Data on the diskette is compared for equality or a 

value less than the data in memory (8-bit data) 

Scan High or Equal Data on the diskette is compared for equality or a 

value greater than the data in memory (8-bit data) 

Recalibrate Read/Write heads retract to track 0 

Sense Interrupt Status Returns the internally stored status registers 

Specify Sets the diskette controller parameters HEAD LOAD, 

HEAD UNLOAD, and STEP RATE 

Sense Drive Status Loads the current drive status into the internal regis¬ 
ter, status register 3 

Seek Read/Write heads move to the specified track 
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Execution State 

The diskette drive controller executes the command as instructed. When the 
operation is complete, the diskette drive controller generates an interrupt to 
the processor and enters the result state. 


NOTE 

The seek and recalibrate commands do not have a result state. 

The overlapped seek or recalibration capability, described in the 
following explanation, is not supported by VAXmate diskette 
drive controllers or industry-standard diskette drive controllers. 

The floppy disk controller chip supports overlapped seeks and 
recalibrations. That is, issuing a seek or recalibrate command to 
two or more drives before the previous seek or recalibrate com¬ 
mands have completed. To provide this feature, the result state 
was eliminated. After issuing one or more seek or recalibrate 
commands, the controlling program must monitor the main 
status register. Bits 3-0 of the main status register reflect the 
status of the corresponding drive. 

Result State 

On completion of a command, the diskette drive controller provides a series of 
status bytes that are read from the data register. These status bytes represent 
the states of corresponding internal registers. Each command has a fixed set of 
status bytes that result from a command. Until all of the status bytes have 
been read, the diskette drive controller will not accept a new command. 

Command and Result Register Sets 

Each command has a specific set of internal registers that must be written 
through the data register. During the result state, each command has a specific 
set of internal registers that must be read through the data register. 

Tables 11-3 through 11-17 define the command and result register sets for the 
various commands. 

Invalid command codes produce a result state that contains only status register 
3. 
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Table 11-3 Register Sets for Read Data Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

DTL 

Data Length 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 

Table 11-4 

Register Sets for Write Data Command 

State 

Order 

Register 

Comment 

Command 

i 

Command 

SK must be 0 


2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

DTL 

Data Length 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

c 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 
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Table 11-5 Register Sets for Read Deleted Data Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

DTL 

Data Length 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 

Table 11-6 

Register Sets for Write Deleted Data Command 

State 

Order 

Register 

Comment 

Command 

1 

Command 

SK must be 0 


2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

DTL 

Data Length 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 
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Table 11-7 Register Sets for Read Track Command 


State 

Order 

Register 

Comment 

Command 

1 

Command 

MT must be 0 


2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

DTL 

Data Length 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 

Table 11-8 

Register Sets for Read ID Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 

MT and SK must be 0 


2 

Head/Unit Select 


Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 
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Table 11-9 Register Sets for Format Track Command 


State 

Order 

Register 

Comment 

Command 

1 

Command 

MT and SK must be 0 


2 

Head/Unit Select 



3 

N 

Sector Size 


4 

SC 

Sectors per track 


5 

GPL 

Gap length 


6 

D 

Fill data 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 

Table 11-10 

Register Sets for Scan Equal Command 

State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

STP 

Interleave (1 or 2) 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 
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Table 11-11 Register Sets for Scan Low or Equal Command 


State 

Order 

Register 

Comment 

Command 

1 

Command 



2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

STP 

Interleave (1 or 2) 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 

Table 11-12 

Register Sets for Scan High or 

Equal Command 

State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 



3 

C 

Cylinder 


4 

H 

Head address 


5 

R 

Sector number 


6 

N 

Sector Size 


7 

EOT 

Last sector for operation 


8 

GPL 

Gap length 


9 

STP 

Interleave (1 or 2) 

Result 

1 

Status Register 0 



2 

Status Register 1 



3 

Status Register 2 



4 

C 

Cylinder 


5 

H 

Head address 


6 

R 

Sector number 


7 

N 

Sector Size 
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Table 11-13 Register Sets for Recalibrate Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 


Result 


None 

Issue a sense interrupt 
status command 

Table 11-14 

Register Sets for Sense Interrupt Status Command 

State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 


Result 

1 

Status Register 0 



2 

PCN 

Present cylinder number 

Table 11-15 

Register Sets for Specify Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

SRT/HUT 



3 

HLT/ND 


Result 


None 

Command does not have a 
result state 
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Table 11-16 Register Sets for Sense Drive Status Command 


State 

Order 

Register 

Comment 

Command 

1 

Command 



2 

Head/Unit Select 


Result 


Status Register 3 


Table 11-17 

Register Sets for Seek Command 


State 

Order 

Register 

Comment 

Command 

i 

Command 



2 

Head/Unit Select 



3 

NCN 

New cylinder number 

Result 


None 

Issue a sense interrupt 
status command 


Programming Example 

The following programming example demonstrates: 

• Initializing the diskette drive controller 

• Using DMA data transfers 

• Recalibrating the diskette drive 

• Seeking to a track 

• Hard formatting a diskette 

CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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#include "kyb.h" 
#include M example.h' 


/* * ******** * **** * ***** * * ***** * ***** * * ** * ** * ***** * * * ******** ******* * * **** / 
/* define constants used in diskette controller example */ 

/***************H<***5|c5|c**5!«5|c3|e5|e5jc5|e**s|e*5|c^**J|e5|c5|e*******5|e**5|e5|c***5|e5k**5|c***s|e5|t5|e*3|c**J|c/ 

/* define bit values for diskette controller control register (DCCR) */ 

#define DRV_SEL 0x01 /* bit mask for drive select */ 

#define FDC_0N 0x04 /* bit value allows fdc to run 

if this bit not set, fdc is reset */ 

#define DMA_INT_0N 0x08 /* value to enable DMA and interrupts to CPU */ 

#define DRVA_M0T0R 0x10 /* bit value to turn on drive a motor */ 

#define DRVB_M0T0R 0x20 /* bit value to turn on drive b motor */ 

/* define bit values for data transfer rate register */ 

#define DTR..500 0x00 /* bit value for 500 Kbit transfer rate */ 

#define DTR_300 0x01 /* VAXmate ■ 250 Kbit transfer rate */ 

#define DTR_250 0x10 /* bit value for 250 Kbit transfer rate */ 

/* define disk change register bit */ 

#define DISK_CHG 0x80 /* diskette changed if set */ 

/* define bit values for FDC main status register */ 

#define FDD0_BUSY 0x01 /* diskette drive 0 busy doing seek */ 

#define FDD1JBUSY 0x02 /* diskette drive 1 busy doing seek */ 

#define FDD2J3USY 0x04 /* diskette drive 2 busy doing seek */ 

#define FDD3JBUSY 0x08 /* diskette drive 3 busy doing seek */ 

#define FDD_BUSY FDDO.BUSY | FDD1JBUSY | FDD2.BUSY I FDD3_BUSY 

#define FDC..CB 0x10 /* controller busy */ 

#define FDC_NDM 0x20 /* in non-DMA mode * execution phase busy */ 

#define DI0_RD 0x40 /* indicates processor should read data reg */ 

#define RQM 0x80 /* data register ready to send or receive */ 
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/* define status register 0 bit values */ 


#define 

SRO_USO 

0x00 

/* 

at interrupt time, unit select = drive 0 

*/ 

#define 

SR0JJS1 

0x01 

/* 

at interrupt time, unit select = drive 1 

*/ 

#define 

SR0.US2 

0x02 

/* 

at interrupt time, unit select * drive 2 

*/ 

#define 

SR0.US3 

0x03 

/* 

at interrupt time, unit select - drive 3 

*/ 

#define 

SRO_HD 

0x04 


/* head address at interrupt time 

*/ 

#define 

SRO_NR 

0x08 


/* diskette drive not ready 

*/ 

#define 

SRO.EC 

0x10 

/* 

equipment check, could not reach track 0 

*/ 

#define 

SRO_SE 

0x20 


/* seek command completed */ 

#define 

SRO_.IC_AT 

0x40 


/* interrupt code = abnormal termination 

*/ 

#define 

SRO.ICLIC 

0x80 


/* interrupt code « invalid command 

*/ 

#define 

SRO_IC_NR 

OxcO 


/* interrupt code ■ drive not ready 

*/ 

#define 

SRO_IC_NT 

0x00 


/* interrupt code = normal termination 

*/ 

/* define status register 

1 bit values */ 


#define 

SR1.MA 

0x01 


/* missing address mark 

*/ 

#define 

SR1__NW 

0x02 


/* write protect signal detected 

*/ 

#define 

SR1_ND 

0x04 

/* couldn’t find sector, or couldn't read ID 

*/ 

#define 

SR1_0R 

0x10 


/* did not receive data in time */ 

#define 

SR1_DE 

0x20 


/* data field or ID field CRC error 

*/ 

#define 

SR1_EN 

0x80 

/* tried to access sector at end of cylinder */ 

/* define status register 

2 bit values */ 


#define 

SR2_MD 

0x01 


/* missing address mark in data field 

*/ 

#define 

SR2J3C 

0x02 


/* bad cylinder 

*/ 

#define 

SR2.SN 

0x04 


/* scan command could not find a sector 

*/ 

#define 

SR2_SH 

0x08 


/* scan equal hit 

*/ 

#define 

SR2_WC 

0x10 


/* wrong cylinder 

*/ 

#define 

SR2_DD 

0x20 


/* CRC error in data field 

*/ 

#define 

SR2_CM 

0x40 


/* deleted data address mark found 

*/ 

/* define status register 

3 bit values */ 


#define 

SR3_US0 

0x00 


/* unit select - drive 0 

*/ 

#define 

SR3.US1 

0x01 


/* unit select - drive 1 

*/ 

#define 

SR3.US2 

0x02 


/* unit select - drive 2 

*/ 

#define 

SR3_US3 

0x03 


/* unit select - drive 3 

*/ 

tdefine 

SR3_HD 

0x04 


/* head address 

*/ 

#define 

SR3_TS 

0x08 


/* drive signal - two side 

*/ 

#define 

SR3_T0 

0x10 


/* drive signal - track 0 */ 

#define 

SR3_RDY 

0x20 


/* drive signal - ready 

*/ 

#define 

SR3.WP 

0x40 


/* drive signal - write protect 

*/ 

#define 

SR3JFT 

0x80 


/* drive signal - FAULT 

*/ 
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/* define base values of fdc commands */ 


#define FDC_RD 0x06 
#define FDC__RDD 0x0c 
#define FDC_WD 0x05 
#define FDC_WDD 0x09 
#define FDCLRT 0x02 
#define FDC_ID 0x0a 
#define FDC_FT OxOd 
#define FDC_SE Oxll 
#define FDCLSLE 0x19 
#define FDCLSHE Oxld 
#define FDC.RECAL 0x07 
#define FDC_SIS 0x08 
#define FDC.SPE 0x03 
#define FDC_SDS 0x04 
#define FDC.SEEK OxOf 
#define FDC_MT 0x80 
#define FDC_MFM 0x40 
#define FDC.SK 0x20 


/* read data */ 

/* read deleted data */ 

/* write data */ 

/* write deleted data */ 

/* read track */ 
/* read ID */ 
/* format track */ 
/* scan equal */ 
/* scan low or equal */ 
/* scan high or equal */ 
/* recalibrate drive */ 
/* sense interrupt status */ 
/* specify */ 
/* sense drive status */ 
/* seek */ 
/* multi“track */ 
/* modified frequency modulation */ 
/* skip deleted data address mark */ 


/* define some general constants */ 


#define RETRY_COUNT 4 


/* maximum retries */ 


*****************************************************/ 
/* define some error codes */ 

/***********************************************************************^ 


#define ERR_FATAL Oxffff /* fatal error of unknown origin */ 
#define ERR_FAT_RD Oxfffe /* fdc was expecting write not read */ 
#define ERR_FAT_WR Oxfffd /* fdc was expecting read not write */ 
#define ERR_T0 Oxfffe /* time out error */ 
#define ERR_DNR Oxfffb /* drive not ready */ 
#define ERR.RECAL 0x0001 /* recalibrate error */ 
#define ERR_SEEK 0x0002 /* seek error */ 
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/* declare structures used in diskette controller example */ 

typedef struct 

{ 

unsigned char dccr; 
unsigned char reservedl; 
unsigned char fdc_stat; 
unsigned char fdc_data; 
unsigned char reserved2; 
unsigned char dtr; 

> FDC; 

#define FDC_BASE (FDC *)0x03F2 /* base address of FDC structure */ 


typedef struct 
{ 


unsigned 

char 

mt; 

/* multi-track 

*/ 

unsigned char 

mfm; 

/* mfm/fm 

*/ 

unsigned 

char 

sk; 

/* skip 

*/ 

unsigned char 

last_cmd; 

/* last command sent to fdc 

*/ 

int busy; 


/* busy flag 

*/ 

int retry; 


/* retry count 

*/ 

unsigned 

char 

dccr; 

/* dccr contents 

*/ 

unsigned 

char 

dtr; 

/* data transfer rate 

*/ 

int hsd; 



/* head settle delay 

*/ 

int msd; 



/* motor start up delay 

*/ 

int mod; 



/* motor off delay 

*/ 

unsigned 

char 

ds; 

/* drive select 0-3 

*/ 

unsigned 

char 

c; 

/* cylinder number 

*/ 

unsigned 

char 

h; 

/* head side 

*/ 

unsigned 

char 

r; 

/* sector number 

*/ 

unsigned 

char 

n; 

/* bytes per sectors 

*/ 

unsigned 

char 

eot; 

/* end of track 

*/ 

unsigned 

char 

sgpl; 

/* sector gap length */ 

unsigned 

char 

fgpi; 

/* format gap length 

*/ 

unsigned 

char 

sc; 

/* sector count 

*/ 

unsigned 

char 

d; 

/* format fill byte 

*/ 

unsigned 

char 

dtl; 

/* data length 

*/ 

unsigned 

char 

stp; 

/* scan skip sector flag 

*/ 

unsigned 

char 

srt; 

/* step rate time 

*/ 

unsigned 

char 

hit; 

/* head load time 

*/ 

unsigned 

char 

hut; 

/* head unload time 

*/ 

unsigned 

char 

nd; 

/* non-DMA mode 

*/ 

> FDC_CMD; 
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/* diskette controller control register */ 
/* I/O space not used by controller */ 
/* diskette controller main status register */ 
/* diskette controller data register */ 
/* I/O space not used by controller */ 

/* read <- diskette change register */ 

/* write -> data transfer rate register */ 





typedef struct 

{ 

unsigned char 
unsigned char 
unsigned char 
unsigned char 
int hsd; 
int msd; 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
> FDD; 


mt; 
mfm; 
sk; 
dtr; 


c; 

h; 

r; 

n; 

eot; 

»gpi: 

*gpi; 

sc; 

dtl; 

srt; 

hit; 

hut; 


typedef struct 

unsigned char stO; 
unsigned char stl; 
unsigned char st2; 
unsigned char st3; 
unsigned char c; 
unsigned char h; 
unsigned char r; 
unsigned char n; 
unsigned char pen; 
unsigned int error; 
unsigned char change; 
} FDCLRESULT; 


/* multi-track */ 
/* mfm/fm */ 
/* skip */ 
/* data transfer rate */ 
/* head settle delay */ 
/* motor start up delay */ 
/* cylinder number */ 
/* head side */ 
/* sector number */ 
/* bytes per sectors */ 
/* end of track */ 
/* sector gap length */ 
/* format gap length */ 
/* sector count */ 
/* data length */ 
/* step rate time */ 
/* head load time */ 
/* head unload time */ 


/* status register 0 */ 

/* status register 1 */ 

/* status register 2 */ 

/* status register 3 */ 

/* cylinder number */ 
/* head side */ 
/* sector number */ 
/* bytes per sectors */ 
/* present cylinder number */ 
/* error code/status */ 
/* diskette change register */ 
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/***********************************************************************/ 
/* declare some external timers */ 

/***********************************************************************/ 

extern int head.settle; /* head settle and motor startup timer */ 

extern int motor_flag; /* automatic motor shut off timer */ 

/*********★******* + ************************:+:****************************/ 
/* declare space for fdc parameter data */ 


FDC_CMD fdc_cmd = 
{ 


0x00, 

FDCLMFM, 

0x00, 

0x00, 

FALSE, 

0x00, 

0x00, 

DTR_500, 

5 , 

128, 

512, 

0x00, 

0x00, 

0x00, 

0x01, 

0x02, 

0x10, 

Ox lb, 
0x54, 
OxOf, 

Oxf 6, 
Oxff, 
0x00, 
OxOd, 
0x32, 
0x08, 
0x00, 


/* not multi-track to start */ 
/* always mfm */ 
/* not skipping */ 
/* no last command yet */ 
/* not busy yet */ 
/* current retries */ 
/* nothing enabled until fdc is reset */ 

/* data transfer rate is 500 Kbits */ 

/* 3.90625 ms * 5 » 19.5312 ms = head settle delay */ 

/* 3.90625 ms * 128 = 500 ms motor startup delay */ 

/* 3.90625 ms * 512 * 2 seconds motor off delay */ 

/* no drive selected */ 
/* cylinder 0 to start */ 
/* head zero to start */ 
/* sector 1 to start */ 
/* 512 bytes per sectors */ 
/* end of track at sector 16 */ 
/* sector gap length */ 

/* format gap length */ 

/* 15 sectors per track */ 
/* format fill byte */ 
/* data length */ 

/* not skipping sectors during scan */ 

/* 3 ms step rate (1 - 16 ms in 1 ms increment) OxOf s 1 ms */ 

/* 50 ms head load time ( 0x01 = 2 ms, 0x02 = 4 ms ...) */ 

/* 128 ms head unload time ( 0x01 = 16 ms, 0x02 = 32ms ...) */ 

/* select dma mode (0x00 * dma mode, 0x01 = non-dma mode) */ 


>; 


FDD fdd[2]; /* place to store diskette parameters */ 

FDC_RESULT fdc_result; /* place to store result and error codes */ 
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/ ***********************************************************************/ 
/* motor.offO - turn diskette drive motors off */ 

/***********************************************************************/ 
motor.off() 

i 

FDC *pfdc = FDC.BASE; 

int intr.flag; /* to hold CPU IF state */ 

fdc.cmd.dccr &= (DRVA.MOTOR | DRVB.MOTOR); /* both motors off */ 

outp(&pfdc->dccr, fdc.cmd.dccr); /* turn them off */ 

intr.flag = int.offO; /* no interrupts please */ 

motor.flag = 0; /* clear motor timer */ 

int.on(intr_flag); /* allow interrupts */ 

> 

/***********************************************************************/ 
/* select() - select the desired drive and turn on motor */ 

/***********************************************************************/ 

select() 

FDC *pfdc = FDC.BASE; 

int intr.flag; /* to hold CPU IF state */ 


if((fdc.cmd.dccr k DRV.SEL) != fdc.cmd.ds || /* if not current */ 

(fdc.cmd.dccr k (DRVA.MOTOR | DRVB.MOTOR)) == 0)/* all motors off */ 

i 


y 


fdc.cmd.dccr k * DRV.SEL; 

fdc.cmd.dccr |= fdc.cmd.ds; 

fdc.cmd.dccr &= (DRVA.MOTOR | DRVB.MOTOR); 

if(lfdc.cmd.ds) fdc.cmd.dccr I* DRVA.MOTOR; 

else fdc.cmd.dccr |= DRVB.MOTOR; 

outp(Apfdc->dccr, fdc.cmd.dccr); 

intr.flag = int.offO; / 

motor.flag = 0; 

int.on(intr.flag); 


/* deselect drives */ 
/* select drive */ 
/* both motors off */ 
/* desired motor on */ 

/* write the register */ 

* no interrupts please */ 
/* clear motor timer */ 
/* allow interrupts */ 


if(Imotor.flag) /* has motor stopped ? */ 


head.settle = fdc.cmd.msd; /* head settle timer to time start up */ 
while(head.settle) /* wait until motor is up to speed */ 


> 

intr.flag = int.offO; 
motor.flag = fdc.cmd.mod; 
int.on(intr.flag); 


/* no interrupts please */ 
/* write the motor off delay time */ 
/* allow interrupts */ 
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/* fdc_in() - read data from fdc data register */ 


fdc_in() 

{ 

FDC *pfdc * FDC_BASE; 
int i; 

head_settle = 2; /* elk cycle 

i = inp(ftpfdc->fdc_stat); 
while(!(i ft RQM)) 
i 

if(!head_settle) 

{ 

fdc_result.error = ERR_TO; 
return; 

> 

else i = inp(ftpfdc->fdc_stat); 

> 

if(i ft DI0_RD) 

return(inp(ftpfdc->fdc_data)); 
else fdc_result.error = ERR_FAT_RD; 

> 


= 3.9 ms, must read in 2 cycles */ 
/* read fdc status register */ 
/* fdc ready ? */ 

/* time out error ? */ 

/* mark error */ 


/* read fdc status register */ 

/* data direction = epu read ? */ 
/* return data read */ 
/* mark fatal error */ 
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/* fdc_out() - write data to fdc data register */ 

/***********************************************************************/ 

fdc.out(value) 

unsigned char value; /* value to write to fdc data register */ 

i 

FDC *pfdc - FDC_BASE; 
int i; 

head.settle =2; /* elk cycle 

i ■ inp(&pfdc->fdc_stat); 
while(!(i k RQM)) 

{ 

if(!head_settle) 

{ 

fdc_result.error * ERR_T0; 
return; 

> 

else i = inp(&pfdc->fdc_stat); 

> 

if ((i k DI0_RD) == 0) 

outp(Apfdc->fdc_data, value); 
else fdc.result.error = ERR_FAT_WR; 

> 

/slcsie*^^********************************************************^*********/ 

/* waitccO - wait for command to complete */ 

/***********************************%***********************************/ 

waitccO 

{ 

while(fdc_cmd.busy) /* wait until command complete */ 

< 

if (!motor_flag) /* time out ? */ 

{ 

fdc_result.error » ERR_T0; /* time out error */ 

return; 

> /* do something useful while waiting, like check date */ 

chk.dtO; /* and time for update. ROM BIOS does an INT 15H */ 

> 


* 3.9 ms, must read in 2 cycles */ 
/* read fdc status register */ 
/* fdc ready ? */ 

/* time out error ? */ 

/* mark error */ 


/* read fdc status register */ 

/* data direction = epu write ? */ 
/* write fdc data register */ 
/* mark fatal error */ 
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if(fdc_result.error) return; 
switch(fdc_cmd.last_cmd) 

case FDC_RECAL: 
case FDCLSEEK: 

head_settle = fdc_cmd.hsd; 
while(head_settle) 

fdc_cmd.last_cmd = FDC_SIS; 
fdc.out(FDC_SIS); 
if(fdc_result.error) return; 
fdc_result. stO = fdc_in(); 
if(fdc_result.error) return; 
fdc_result.pen = fdc_in(); 
if(fdc_result.error) return; 
break; 


/* error ? */ 
/* discover last command issued */ 


/* set last command issued */ 
/* sense interrupt status */ 
/* error ? */ 
/* read stO results */ 
/* error ? */ 
/* read present cylinder number */ 

/* error ? */ 


/* recalibrate ? */ 
/* seek ? */ 
/* set head settle delay timer */ 
/* wait for head settle to time out */ 


default:/* all other commands except FDCLSPE, FDCLSIS, and FDCLSDS */ 


fdc_result.stO = fdc_in(); 
if(fdc_result.error) return; 
fdc.result.stl = fdc_in(); 
if(fdc_result.error) return; 
fdc_result.st2 = fdc_in(); 
if(fdc_result.error) return; 
fdc_result.c = fdc_in(); 
if(fdc_result.error) return; 
fdc__result .h = fdc_in(); 
if(fdc_result.error) return; 
fdc_result.r = fdc_in(); 
if(fdc..result.error) return; 
fdc_result.n = fdc_in(); 
if(fdc_result.error) return; 
break; 


/* read stO results */ 
/* error ? */ 
/* read stl results */ 
/* error ? */ 
/* read st2 results */ 
/* error ? */ 
/* read cylinder results */ 
/* error ? */ 
/* read head results */ 
/* error ? */ 
/* read sector results */ 
/* error ? */ 
/* read bytes/sector results */ 
/* error ? */ 
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/***********************************************************************/ 
/* specify() - set the diskette drive characteristics */ 

Z^**********************************************************************/ 


specify() 

{ 

FDC * p fdc = FDCJ3ASE; 

unsigned char uc; /* temporary variable */ 


outp(&pfdc->dtr, fdc_cmd.dtr); 
outp(&pfdc->dccr, fdc_cmd.dccr) 
fdc_cmd.last_cmd = FDC_SPE; 
fdevout(FDCLSPE); 
if(fdc_result.error) return; 
uc * fdc_cmd.srt << 4; 
uc 1= fdc_cmd.hut; 
fdc_out(uc); /* 

if(fdc_result.error) return; 
uc = fdc_cmd.hlt « 1; 
uc |= fdc_cmd,nd; 
fdevout(uc); 

> 


/* set data transfer rate */ 
/* set control register */ 
/* last command is specify */ 
/* issue specify command */ 
/* error ? */ 
/* specify step rate */ 
/* specify head unload time */ 
issue step rate and head unload time */ 

/* error ? */ 
/* specify head load time */ 
/* specify dma mode */ 
/* issue head load time and dma mode */ 
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/* fdc_issue() - issue all fdc commands except specify and sis */ 

/s|c9|c:k9|(:|c:i|c$$$:*$9|c&s|c:>|c*Ht:****Hc****:k******s|c*:i|c*$*$$**:fc*********$******$***’l'*3|<:>l'$’|t)|c/ 


fdc_issue(cmd, drv) 

int cmd; /* desired command */ 

int drv; /* desired drive 0 or 1 */ 

{ 

FDC *pfdc = FDC.BASE; 
char oline[20]; 


fdc_cmd.ds = drv; 
select(drv); 
fdc_out(FDC_SDS); 
if(fdc_result.error) return; 
fdc__out((fdc_cmd.h << 2) | fdc_cmd.ds); 
if(fdc_result.error) return; 
fdc_result.st3 = fdc_in(); 
if(fdc_result.error) return; 

sprintf(oline, ”%04x %04x H , pfdc, &pfdc->dtr) 
disp_str(16, 1, oline); 

f dc ..result. change = inp(&pf dc->dtr) & 0x80; 
if(fdc_result.st3 & SR3_RDY) 

{ 

fdc_cmd.last_cmd = cmd; /* 

switch(cmd) 


/* indicate the drive 
/* select appropriate drive 
/* sense drive status 
/* error ? 
/* second byte of SDS 
/* error ? 
/* read st3 results 
/* error ? 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/* read disk change reg */ 
/* drive ready ? */ 

set last command issued */ 


case FDC_SDS: 
return; 
break; 


case FDC_RECAL: 


/* : 

recalibrate 

? 

*/ 

fdc_out(cmd); 


/* 

issue byte 

1 

*/ 

if (f dc__result. error) 

return; 


/* error 

? 

*/ 

fdc_out(fdc_cmd.ds); 


/* 

issue byte 

2 

*/ 

break; 






case FDC_SEEK: 



/* seek 

7 

*/ 

fdc_out(cmd); 


/* 

issue byte 

1 

*/ 

if(fdc_result.error) 

return; 


/* error 

7 

*/ 

fdc_out((fdc_cmd.h << 2) | fdc_cmd.ds); 

/* 

issue byte 

2 

*/ 

if(fdc_result.error) 

return; 


/* error 

7 

*/ 

fdc_out(fdc_cmd.c); 


/* 

issue byte 

3 

*/ 


break; 
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case FDC_ID: 

fdc_out(fdc_cmd.mfm | emd) ; 
if(fdc_result.error) return; 
fdc_out((fdc_cmd.h « 2) I fdc_cmd.de); 
break; 


case FDC_FT: 

fdc_out(fdc.cmd.mfm I cmd); 

if (f dc..result. error) return; 

fdc_out((fdc_cmd.h « 2) | fdc_cmd.de); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.n); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.sc); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.fgpl); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.d); 

if(fdc_result.error) return; 

break; 


case FDC_RD: 

case FDC_RDD: /* 

case FDC_WD: 

case FDCLWDD: / 

fdc_out(fdc_cmd.mt | fdc_cmd.mfm I fdc_cmd 
if(fdc_result.error) return; 
fdc_out((fdc_cmd.h« 2) | fdc_cmd.ds); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.c); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.h); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.r); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.n); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.eot); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.sgpl); 
if(fdc_result.error) return; 
fdc_out(fdc_cmd.dtl); 
break; 


/* read ID ? */ 
/* issue byte 1 */ 
/* error ? */ 
/* issue byte 2 */ 

/* format track ? */ 
/* issue byte 1 */ 
/* error ? */ 
/* issue byte 2 */ 
/* error ? */ 
/* issue byte 3 */ 
/* error ? */ 
/* issue byte 4 */ 
/* error ? */ 
/* issue byte 5 */ 
/* error ? */ 
/* issue byte 6 */ 
/* error ? */ 


/* read data ? */ 
read deleted data ? */ 
/* write data ? */ 
write deleted data */ 
sk | cmd);/* byte 1 */ 
/* error ? */ 
/* issue byte 2 */ 
/* error ? */ 
/* issue byte 3 */ 
/* error ? */ 
/* issue byte 4 */ 
/* error ? */ 
/* issue byte 5 */ 
/* error ? */ 
/* issue byte 6 */ 
/* error ? */ 
/* issue byte 7 */ 
/* error ? */ 
/* issue byte 8 */ 
/* error ? */ 
/* issue byte 9 */ 
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case FDCLRT: 

fdc_out(fdc_cmd.mfm | fdc_cmd.sk I cmd); 

if(fdc_result.error) return; 

fdc_out((fdc_cmd.h << 2) | fdc_cmd.de); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.c); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.h); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.r); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.n); 

if(fdc_re8ult.error) return; 

fdc_out(fdc_cmd.eot); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.sgpl); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.dtl); 

break; 


/* read a track ? */ 
/* issue byte 1 */ 
/* error ? */ 
/* issue byte 2 */ 
/* error ? */ 
/* issue byte 3 */ 
/* error ? */ 
/* issue byte 4 */ 
/* error ? */ 
/* issue byte 5 */ 
/* error ? */ 
/* issue byte 6 */ 
/* error ? */ 
/* issue byte 7 */ 
/* error ? */ 
/* issue byte 8 */ 
/* error ? */ 
/* issue byte 9 */ 


case FDC_SE: 
case FDC_SHE: 
case FDC_SLE: 

fdc_out(fdc_cmd.mt | fdc_cmd.mfm | 

if(fdc.result.error) return; 

fdc_out((fdc_cmd.h << 2) | fdc_cmd 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.c); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.h); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.r); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.n); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.eot); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.sgpl); 

if(fdc_result.error) return; 

fdc_out(fdc_cmd.stp); 

break; 


/* scan high or equal 
/* scan low or equal 
fdc_cmd.sk I cmd);/* byte 
/* error 

ds); /* issue byte 

/* error 
/* issue byte 
/* error 
/* issue byte 
/* error 
/* issue byte 
/* error 
/* issue byte 
/* error 
/* issue byte 
/* error 
/* issue byte 
/* error 
/* issue byte 
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/* drive not ready error */ 


else 

{ 

fdc_result.error = ERR_DNR; 
return; 

> 

if(fdc_result.error) return; /* error ? */ 

fdc_cmd.busy = TRUE; 

waitccO; /* wait for command complete */ 

disp_status(&fdc_result, &fdc_cmd); /* display result status */ 


/* fdc_init() - initialize diskette controller */ 

fdc.init() 

{ 

FDC *pfdc = FDC_BASE; 
int intr_flag; 


intr_flag = int_off(); 

outp(Apfdc->dccr, DMA_INT_0N); 

fdc.cmd.dccr = DMA_INT__0N | FDC.ON; 

outp(&pfdc->dccr, fdc_cmd.dccr); /* 

iv_init(OxOe); /* initialize 

int_on(intr_flag); 

imask(0, 6, 1); 


/* reset the fdc */ 
/* fdc not reset */ 
allow communications */ 
the interrupt vector */ 

/* enable PIC input */ 


/* fdc_rest() - restore diskette controller and interrupt vector */ 


fdc_rest() 

FDC *pfdc = FDCJ3ASE; 

/* reset the fdc */ 
/* disable PIC input */ 
/* fdc not reset */ 
/* allow communications */ 
/* restore the interrupt vector */ 


outp(fcpfdc->dccr, 0); 
imask(0, 6, 0); 

fdc_.cmd.dccr = DMA_INT_0N | FDC_0N; 
outp(&pfdc->dccr, fdc_cmd.dccr); 
iv_rest(OxOe); 
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/* fdc_int_hand() - fdc interrupt handler */ 


fdc_int_hand() 

fdc_cmd.busy = FALSE; /* no longer busy */ 

eoi(0); 

> 

/* fdc() - execute diskette controller examples */ 


fdc () 

static MESSAGE mfdc[] = /* fdc menu */ 



3, 

27, 

’’Diskette Controller Example” >, 


5, 

27, 

”F1. 

Turn drive A motor on” 

■c 

6. 

27, 

”F2. 

Turn drive A motor off” >, 

•c 

7, 

27, 

”F3. 

Recalibrate” >, 

i 

8, 

27, 

”F4. 

Seek track 40” >, 

i 

9, 

27, 

”F5. 

Format diskette” >, 

i 

10, 

27, 

"F6. 

Read ID” >, 

< 

12, 

27, 

”F10. 

Return to Main menu” >, 


0, 

o, 

0 >, 





unsigned char tmp; 
unsigned char sum; 
char line[512]; 
char oline[512]; 
int i; 
int r; 

FDC *pfdc = FDC.BASE; 
char *pc; 

char far *fpc = oline; 

long 1 = (long)fpc; 

long 11; 

long 12; 

int pr; 

int pa; 


/* to hold CMOS byte read */ 
/* to hold calculated checksum */ 
/* to hold input line */ 
/* to hold output line */ 
/* to hold menu selection */ 
/* temp value */ 


#define ROW 16 
#define COL 17 
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disp.menu(mfdc); /* display the fdc menu */ 

11 = 1 k OxOOOOffff; /* build address of buffer for DMA controller */ 

12 - 1 » 16; 

12 «« 4; 

1 * 12 + 11 ; 

11 - 1 » 16; 

pr = (int)ll; /* pointer to buffer */ 

11 = 1 k OxOOOOffff; 

pa * (int)ll; /* page register value */ 

specify(); 

line[0] * 0; /* null terminated */ 

while(1) /* forever (see F10) */ 

i 

disp_8tatus(&fdc_re8ult, Afdc.cmd); /* display result status */ 

line[0] - get_fkey(); /* get a function key for menu selection */ 

switch(line[0]) /* determine menu selection */ 

{ 

case FI: /* turn drive motor on */ 

fdc.cmd.ds * 0; 
select(); 
break; 

case F2: /* turn drive motor off */ 

motor_off(); 
break; 


case F3: /* recalibrate drive */ 

select(0); 

fdc.issue(FDCLRECAL, 0); 
fdc.issue(FDC.RECAL, 0); 
fdc.issue(FDC_ID, 0); 
break; 


case F4: /* seek to track 40 */ 

select(0); 
fdc.cmd.c = 40; 
fdc.issue(FDC.SEEK, 0); 
fdc.issue(FDC.ID, 0); 
break; 
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/* hard format a diskette - interleave - 1 */ 


case F5: 
select(0); 
fdc.issue (FDC_RECAL, 0); 
fdc.issue(FDG.RECAL, 0); 
fdc_is8ue(FDC_ID, 0); 
for(i * 0; i < 80; i++) 

fdc_cmd.c = i; 
fdc_issue(FDC_SEEK, 0); 
fdc_cmd.h = 0; 
pc = oline; 

for(r = 1; r < 16; r++) 

*pc++ » (char)i; 

*pc++ = *\000’; 

*pc++ - (char)r; 

*pc++ * '\002 *; 

> 

r = (int) (1 » 16) ; 
dma_transfer(2, pr, pa, 60, 8); 
fdc_issue(FDC_FT, 0); 
fdc_cmd.h = 1; 
pc ■ oline; 

for(r = 1; r < 16; r++) 

{ 

*pc++ = (char)i; 

*pc++ - *\001’; 

*pc++ = (char)r; 

*pc++ = *\002'; 

> 

r = (int) (1 » 16); 
dma_transfer(2, pr, pa, 60, 8); 
fdc.issue(FDC_FT, 0); 

> 

break; 


/* side 0 */ 
/* build sector table */ 


/* setup DMA */ 
/* format track */ 
/* side 1 */ 

/* build sector table */ 


/* setup DMA */ 
/* format track */ 
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/* read any sector ID */ 


case F6: 
select(0); 

f dc_issue(FDC.RECAL, 0); 
f dc_issue(FDC.RECAL, 0); 
fdc.issue(FDC.ID, 0); 
for(i = 0; i < 80; i++) 

fdc.cmd.c ■ i; 
fdc.issue(FDC.SEEK, 0); 
fdc.cmd.h = 0; 
fdc.issue(FDC.ID, 0); 
fdc.cmd.h = 1; 
fdc.issue(FDC.ID, 0); 

> 

break; 

case F10: /* return to caller (main menu) */ 

return; 

> 

> 

> 
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disp.status(pres, pcmd) 


/* display status */ 


FDC_RESULT *pres; 

FDC_CMD *pcmd; 

char oline[50]; 

sprintf(oline, "Error status : 0x%04x", pres->error); 
disp_str(19, 1, oline); 

sprintf(oline, "Status reg 0 : 0x%02x", pres->stO); 

disp_str(20, 1, oline); 

sprintf(oline, "Status reg 1 : 0x%02x", pres->stl); 

disp_str(21, 1, oline); 

sprintf(oline, "Status reg 2 : 0x%02x", pres->st2); 

disp_str(22, 1, oline); 

sprintf (oline, "Status reg 3 : 0x # /,02x" , pres->st3) ; 

disp_str(23, i, oline); 

sprintf(oline, "Present Cyl Num: 0x%02x", pres->pcn); 
disp_str(24, 1, oline); 

sprintf (oline, "Change reg : 0x°/#02x" , pres->change) ; 

disp_str(19, 41, oline); 

sprintf(oline, "Cylinder (C): 0x%02x", pres->c); 

disp_str(20, 41, oline); 

sprintf(oline, "Head (H): 0x%02x", pres->h); 

disp_str(21, 41, oline); 

sprintf (oline, "Sector (R) : 0x7,02x" , pres->r) ; 
disp_str(22, 41, oline); 

sprintf (oline, "Sectors per track (N) : Ox7,02x", pres->n) ; 
di8p_str(23, 41, oline); 

sprintf (oline, "Last command : 0x7,04x", pcmd->last_cmd) ; 
disp_8tr(24, 41, oline); 
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Chapter 12 
Hard Disk Drive Controller 


Introduction 

The hard disk controller provides an interface between a hard disk drive and 
the workstation microprocessor. The hard disk controller supports the following 
features: 

• A 16-bit data path and an 8-bit input/output (I/O) path 

• ECC correction 

• Programmed I/O data transfers 

• Field formatting with unlimited sector interleave 

• Drives with a maximum of 16 heads and 1024 cylinders 

Hard Disk Controller Registers 

The hard disk controller has 13 registers that control hard disk operations and 
provide status information. These registers are mapped to a set of primary or 
secondary I/O addresses. Table 12-1 lists the registers and the corresponding 
primary and secondary I/O addresses. 
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Table 12-1 Hard Disk Controller Registers 


Primary Secondary R/W Register 

Address Address 


01F0H 

0170H 

R/W 

01F1H 

0171H 

W 

01F1H 

0171H 

R 

01F2H 

0172H 

R/W 

01F3H 

0173H 

R/W 

01F4H 

0174H 

R/W 

01F5H 

0175H 

R/W 

01F6H 

0176H 

R/W 

01F7H 

0177H 

W 

01F7H 

0177H 

R 

03F6H 

0376H 

W 

03F6H 

0376H 

R 

03F7H 

0377H 

R 


Data register (16 bits) 

Write Precompensation Cylinder 

Error Register 

Sector Count 

Sector Number 

Cylinder Number - Low Byte 

Cylinder Number - High Byte 

SDH (sector size, drive, and head) 

Command Register 

Status Register 

Hard Disk Register 

Alternate Status Register 

Digital Input Register 
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11 


10 


9 


8 


Data Register (01F0H/0170H) 

15 14 13 12 



-r~ 

i 

-1-1-1 

DATA REGISTER - 

I i I 

-1- 

HIGH BYTE 

1 


—I- 

1 

7 


6 5 4 

3 2 

i 

0 


i 

1 

i i i 

DATA REGISTER - 

l l l 

1 

LOW BYTE 

l l 


1 

1 

Bit 

R/W 

Description 




15-0 

R/W 

DATA 





The data register provides a 16-bit data path to the sector buffer. This register 
is accessible only during execution of a read or write command. 

Except for the four ECC bytes of a read long or write long command, all data 
transfers are 16-bit transfers. 

After transferring the data of a read long or write long command, the four 
ECC bytes are transferred one byte at a time. The ECC bytes are transferred 
through the high byte. The hard disk controller requires a minimum of 2 /js 
between ECC byte transfers. To transfer an ECC byte, the data request (DRQ) 
status bit (status register bit 3) must be set. The status register is defined later 
in this chapter. 
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Write Precompensation Register (01F1H/0171H) 

76543210 


-1- 

-1- 

-1-1-1- 

-1- 

-1- 



CYLINDER NUMBER / 4 



_1 

1 

_1_1_1_ 

_1 

1_ 


Bit R/W Description 


7-0 W This register specifies the cylinder at which the hard disk control¬ 
ler begins applying write precompensation. The value written to 
this register is the desired cylinder number divided by 4. 
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Error Register (01F1H/0171H) 


7 

6 

5 

4 

3 

2 

1 

0 

BAD 

BLOCK 

DETECT 

ECC 

ERROR 

0 

£91 

0 

ABORTED 

COMMAND 

DETECT 

TRACK 0 
ERROR 

DAM 

NOT 

FOUND 


Bit R/W Description 


7 R BAD BLOCK DETECT 
0 = No error 

1 = The controller read a sector ID field that contained a bad 
block mark 

6 R ECC ERROR 

0 = No error 

1 = An ECC syndrome error was detected 

5 R Always 0 

4 R ID NOT FOUND 

0 = No Error 

1 = The hard disk controller failed to find the desired cylinder, 

head, sector, or size parameter within eight revolutions of the 
disk, or an ID field CRC error has occurred. 

3 R Always 0 

2 R ABORTED COMMAND DETECT 

0 = No error 

1 = The hard disk controller aborted a command 

If a command is issued while the status signal, DRIVE READY L, 
is inactive or the status signal, WRITE FAULT L is active, the 
hard disk controller sets this bit. 

I R TRACK 0 ERROR 

0 = No error 

1 = The hard disk controller executed a restore command, issued 
2047 step pulses, and did not detect track 0. 

0 R DAM NOT FOUND - Data Address Mark Not Found 
0 = No error 

1 = The hard disk controller read the correct sector ID field, but 
it did not contain a data address mark. 
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For the following conditions, the error register contains valid data: 

• After a command completion interrupt, if the status register error bit 
(bit 0) equals 1, this register indicates the specific error condition. 

• On power-up or receiving a diagnose command, the hard disk controller 
executes a set of diagnostic tests. On completion of those tests, the hard 
disk controller places a result code in this register. The result code is 
one of the codes listed in Table 12-2. For this condition, the status regis¬ 
ter error bit (bit 0) is ignored. 


Table 12-2 Hard Disk Controller Diagnostic Result Codes 


Value Meaning 


01H No error 

02H WD1015/WD2010 controller error 

03 H Sector Buffer RAM data error 

04H WD1015/WD11C00A-22 Register access error 

05H WD1015 ROM checksum or RAM data error 
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Sector Count Register (01F2H/0172H) 



7 

6 5 4 3 

2 

1 

0 


1 

1 

1 1 1 1 

SECTOR COUNT 

1 1 1 1 

1 

1 



Bit 

R/W 

Description 




7-0 

R/W 

The sector count for an operation 

A value of 00H indicates a 256 sector transfer. 




For a read, write, or read verify command, this register specifies the number of 
sectors transferred. For the format command, this register specifies the 
number of sectors to format. During a multiple sector operation, after each 
sector is transferred or formatted, the hard disk controller decrements the 
sector count. 

Sector Number Register (01F3H/0173H) 

76543210 

- 1 - 1 - 1 - 1 - 1 - 1 - 1 - 

SECTOR NUMBER 

_I_I_I_I_1_I_I_ 


Bit R/W Description 

7-0 R/W The first sector for an operation 


For a read, write, read verify, or format command, this register specifies the 
first sector of an operation. During multiple sector operations, after each sector 
is transferred or formatted, the hard disk controller increments the sector 
number. 
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0 


Cylinder Number Low Register (01F4H/0174H) 

7 6 5 4 3 2 1 


1 - 1 - 1 - 1 - 1 - 1 - 

- 1 - 

' 1 

CYLINDER NUMBER 

(LOW BYTE) 

_ 1 _ 1 _1_1_1_ 

_ 1 _ 

, 


Bit R/W Description 

7-0 R/W Lower 8 bits of the 10-bit cylinder number 


This register specifies the 8 least significant bits of the 10-bit cylinder 
number. The cylinder number high register specifies the 2 most significant 
bits. 


Cylinder Number High Register (01F5H/0175H) 



7 

6 

5 

4 

3 

2 

1 0 

0 

0 

0 

0 

0 

0 

i 

CYLINDER NUMBER 
(HIGH BYTE) 

l 

Bit 

R/W 

Description 





7-2 

R/W 

Always 0 





1-0 

R/W 

Upper 2 bits of the 10-bit cylinder number 



This register specifies the 2 most significant bits of the 10-bit cylinder 
number. The cylinder number low register specifies the 8 least significant 
bits. 
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SDH Register (01F6H/0176H) 

76543210 


ECC 


DATA 

DRIVE 

-1-1-1- 

HEAD SELECT 

SELECT 

0 

SIZE 

SELECT 

_1_1_1_ 


Bit R/W Description 


7 R/W ECC SELECT 

0 = CRC used to check the data field of a sector 
1 = ECC used to check the data field of a sector (ROM BIOS 
requires ECC) 

6 R/W Always 0 

6 R/W DATA SIZE 

0 = 256 byte records (read operations only) 

1 = 512 byte records 

4 R/W DRIVE SELECT 

0 = Hard disk drive 0 selected 
1 = Hard disk drive 1 selected 

3-0 R/W HEAD SELECT 


The binary value in bits 3-0 selects the corresponding head. To use 
bit 3 of this field, the ENABLE-HEAD-SELECT-BIT-3 (bit 3 of 
the hard disk register) must equal 1. Otherwise, bit 3 is ineffective 
and bits 2-0 have a range of 0-7. 
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Command Register (01F7H/0177H) 



7 

6 5 4 3 

2 

1 

0 



COMMAND CODES 





1 

1 1 1 1 

1 

1 

1 

Bit 

R/W 

Description 




7-0 

W 

Hard disk controller command codes 





When command codes are written to this register, the hard disk controller exe¬ 
cutes the command immediately. If the hard disk controller is busy (status reg¬ 
ister bit 7 equals 1), command codes cannot be written to the command 
register. When the hard disk controller detects a command error condition, the 
hard disk controller aborts the command and sets the ABORTED COMMAND 
DETECT bit (error register bit 2). Some of the common command error condi¬ 
tions are: 

• WRITE FAULT is active 

• DRIVE READY is inactive 

• SEEK COMPLETE is inactive 

• Command code was invalid 

The hard disk controller has the following commands: 

• Restore 

• Seek 

• Read Sector 

• Write Sector 

• Format Track 

• Read Verify 

• Diagnose 

• Set Parameter 
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Restore Command 


7 

6 

5 

4 

3 

2 1 

0 


1 

1 



1 



RESTORE 

COMMAND 



STEP RATE 


0 

0 

_J_1 

0 

1 


1_1_1 

1_ 


Bit Description 


7-4 

RESTORE COMMAND (Always 0001) 


3-0 

STEP RATE 

0000 = 35.0 jus 

1000 = 

4.0 ms 


0001 = 

0.5 ms 

1001 = 

4.5 ms 


0010 = 

1.0 ms 

1010 = 

5.0 ms 


0011 = 

1.5 ms 

1011 = 

5.5 ms 


0100 = 

2.0 ms 

1100 = 

6.0 ms 


0101 = 

2.5 ms 

1101 = 

6.5 ms 


0110 = 

3.0 ms 

1110 = 

3.2 ns 


0111 = 

3.5 ms 

1111 = 

16.0 jus 


Until a terminating condition occurs, the hard disk controller issues step pulses 
to the selected drive. The terminating conditions are: 

• The TRACK 0 signal from the drive becomes active, which indicates a 
successful completion of the command. In this case, the hard disk con¬ 
troller sets SEEK COMPLETE (status register bit 4) to 1. 

• The hard disk controller issues 2047 step pulses, which causes a 
TRACK 0 ERROR (error register bit 3). 

• The DRIVE READY signal becomes inactive, which causes an 
ABORTED COMMAND DETECT (error register bit 2). 

• The WRITE FAULT signal becomes active, which causes an ABORTED 
COMMAND DETECT (error register bit 2). 

While a restore command is in progress, the SEEK COMPLETE signal from 
the drive controls the step rate. Bits 3-0 set the implied seek step rate. On 
termination of this command, the hard disk controller generates an interrupt to 
the CPU. 
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Seek Command 


7 

6 

5 

4 

3 


2 1 


0 


i 

SEEK 

i i 

COMMAND 



i 

STEP RATE 

1 


0 

1 

1 

1 







J_ 

_J_L 



1 

_1_ 

| 



Bit Description 

7-4 SEEK COMMAND (Always 0111} 

3-0 STEP RATE 


0000 = 

35.0 /us 

1000 = 

4.0 ms 

0001 = 

0.5 ms 

1001 = 

4.5 ms 

0010 = 

1.0 ms 

1010 = 

5.0 ms 

0011 = 

1.5 ms 

1011 = 

5.5 ms 

0100 = 

2.0 ms 

1100 = 

6.0 ms 

0101 = 

2.5 ms 

1101 = 

6.5 ms 

0110 = 

3.0 ms 

1110 = 

3.2 n s 

0111 = 

3.5 ms 

1111 = 

16.0 fxs 


Until a terminating condition occurs, the hard disk controller issues step pulses 
to the selected drive. The terminating conditions are: 


• The SEEK COMPLETE signal from the drive becomes active, which in¬ 
dicates a successful completion of the command. In this case, the hard 
disk controller sets SEEK COMPLETE (status register bit 4) to 1. 

• The DRIVE READY signal becomes inactive, which causes an 
ABORTED COMMAND DETECT (error register bit 2). 

• The WRITE FAULT signal becomes active, which causes an ABORTED 
COMMAND DETECT (error register bit 2). 


The seek command moves the read/write heads to the cylinder specified by the 
10-bit value in the registers cylinder low and cylinder high. Bits 3-0 set the 
implied seek step rate and control the step rate of the seek command. After 
the hard disk controller starts the seek, the hard disk controller generates an 
interrupt to the CPU. This interrupt indicates that the hard disk controller is 
ready to accept another command. It does not indicate that the seek is com¬ 
plete. To determine when the seek is complete, the application program or 
driver must monitor status register bit 4. When status register bit 4 equals 1, 
the seek is complete. 
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Read Sector Command 
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READ SECTOR COMMAND 
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READ 

LONG 
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DISABLE 


Bit Description 


7-2 READ SECTOR COMMAND (Always 001000) 

1 READ LONG 

0 = After transferring a sector of data, the hard disk controller 
calculates and checks the data field ECC. If a correctable 
error occurs, the hard disk controller sets CORRECTED 
DATA (status register bit 2). If an uncorrectable error occurs, 
the hard disk controller sets ECC ERROR (error register bit 
6) and ERROR (status register bit 0). If an uncorrectable 
error occurs during a multiple sector read, the multiple sector 
read is terminated. 

1 = The hard disk controller does not calculate the data field 

ECC. After transferring a sector of data, the hard disk con¬ 
troller transfers the four data field ECC bytes. The four ECC 
bytes are transferred one at a time in the high byte of the 
word. Until DRQ (status register bit 3) equals 1, an ECC byte 
is not ready for transfer. The hard disk controller requires at 
least 2 jus between ECC byte transfers. 

0 RETRIES DISABLE 

0 = Retries enabled 
1 = Retries disabled 

To read a sector from the hard disk, the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con¬ 
troller selects the indicated head, performs any implied seek, and 
waits for the index pulse. On receipt of the index pulse, the hard 
disk controller begins scanning the track for a valid sector ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 
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Bit 


Description (Read Sector Command - cont.) 


If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 

If retries are disabled and the hard disk controller fails to read a 
valid ID field within two attempts, the hard disk controller sets 
ID Not Found (error register bit 4) and ERROR (status register 
bit 0). Also, the hard disk controller does not perform an auto-seek 
or an auto-scan. 


The read sector command transfers the specified number of sectors from the 
selected drive. If the heads are not positioned at the specified cylinder, the con¬ 
troller performs an implied seek to the proper cylinder. The step rate used is 
that of the most recently executed restore or seek command. Multiple sector 
reads can cross head and cylinder boundaries. If the DRIVE READY signal 
becomes inactive, or the WRITE FAULT signal becomes active, the hard disk 
controller terminates the command and sets ABORTED COMMAND DETECT 
(error register bit 2) and ERROR (status register bit 0). 

When each sector is stored in the sector buffer and ready to be read by the 
CPU, the hard disk controller generates an interrupt request to the CPU. The 
hard disk controller does not generate an interrupt request to indicate com¬ 
mand completion. 
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Write Sector Command 
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Bit Description 


7-2 WRITE SECTOR COMMAND (Always 001100) 

1 WRITE LONG 

0 = The hard disk controller calculates the data field ECC and ap¬ 
pends the ECC to the data field. 

1 = The hard disk controller does not calculate the data field 

ECC. After accepting a sector of data, the hard disk control¬ 
ler accepts the four data field ECC bytes. The four ECC bytes 
are transferred one at a time in the high byte of the word size 
data register. Until DRQ (status register bit 3) equals 1, an 
ECC byte is not ready for transfer. The hard disk controller 
requires at least 2 /us between ECC byte transfers. 

0 RETRIES DISABLE 

0 = Retries enabled 
1 = Retries disabled 

To write a sector from the hard disk, the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con¬ 
troller selects the indicated head, performs any implied seek, and 
waits for the index pulse. On receipt of the index pulse, the hard 
disk controller begins scanning the track for a valid sector ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 

If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 
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Bit 


Description (Write Sector Command - cont.) 


If retries are disabled and the hard disk controller fails to read a 
valid ID field within two attempts, the hard disk controller sets 
ID Not Found (error register bit 4) and ERROR (status register bit 
0). Also, the hard disk controller does not perform an auto-seek or 
an auto-scan. 


The write sector command transfers the specified number of sectors to the se¬ 
lected drive. If the heads are not positioned at the specified cylinder, the con¬ 
troller performs an implied seek to the proper cylinder. The step rate used is 
that of the most recently executed restore or seek command. Multiple sector 
writes can cross head and cylinder boundaries. If the DRIVE READY signal 
becomes inactive, or the WRITE FAULT signal becomes active, the hard disk 
controller terminates the command and sets ABORTED COMMAND DETECT 
(error register bit 2) and ERROR (status register bit 0). 

After the write sector command has been issued, immediately write the first 
sector of data to the data buffer (monitor DRQ, status register bit 3). When 
each sector is written to the hard disk, the hard disk controller generates an 
interrupt request to the CPU. The hard disk controller does not generate an 
interrupt request to indicate command completion. 
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Format Track Command 
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Bit 

Description 



7-0 

FORMAT TRACK COMMAND (Always 01010000) 



Using data from the internal registers and the sector buffer, the format track 
command formats a single track at the specified cylinder and head location. 

Before formatting a hard disk, the SDH register must be loaded and a restore 
command must be issued. Assuming that a series of sequential format track 
commands are issued to format the hard disk, only one restore command is 
required. Prior to each format track command, the sector count register must 
be loaded with the number of sectors per track and the cylinder registers must 
be loaded with the cylinder number. 

Instead of providing normal read/write data, the sector buffer provides sector 
header information. Also, the organization of this sector header information 
specifies the sector interleave. Table 12-3 lists the data (in memory order) that 
is required for an interleave factor of 2. The data transfer using this table is 
256 words long. A bad block is specified by replacing the 00H (normal block 
mark) with an 80H (bad block mark). The sector interleave table is loaded into 
the sector buffer in the same manner as a sector write. That is, the format 
track command is issued and the sector buffer is loaded immediately (monitor 
DRQ, status register bit 3). 

When a track has been formatted, the hard disk controller clears the sector 
buffer to zeros and issues a command completion interrupt. Following the next 
format track command, the sector buffer must be reloaded. 

The hard disk controller does not produce any error reports for this command. 
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Table 12-3 Memory Image of a Sector Interleave Table 


Offset 

2-Byte 

Sector 

Number 
(High Byte) 

Sequence 

Sector 

Status (00H = Good, 80H = Bad) 

(Low Byte) 

00H 

01H 

00H 

02H 

OAH 

00H 

04H 

02H 

00H 

06H 

OBH 

00H 

08H 

03H 

00H 

OAH 

OCH 

00H 

OCH 

04H 

00H 

OEH 

ODH 

00H 

10H 

05H 

00H 

12H 

OEH 

00H 

14H 

06H 

00H 

16H 

OFH 

00H 

18H 

07H 

00H 

1AH 

10H 

OOH 

1CH 

08H 

00H 

1EH 

11H 

OOH 

20H 

09H 

OOH 

22H 

FFH 

FFH 


FFH 

FFH 


FFH 

FFH 

# 

FFH 

FFH 

FFH 

FFH 

FFH 
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Read Verify Command 
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7-1 READ VERIFY COMMAND (Always 0100000) 

0 RETRIES DISABLE 

0 = Retries enabled 
1 = Retries disabled 

To read a sector from the hard disk, the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con¬ 
troller selects the indicated head, performs any implied seek, and 
waits for the index pulse. On receipt of the index pulse, the hard 
disk controller begins scanning the track for a valid sector ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 

If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 

If retries are disabled and the hard disk controller fails to read a 
valid ID field within two attempts, the hard disk controller sets 
ID Not Found (error register bit 4) and ERROR (status register 
bit 0). Also, the hard disk controller does not perform an auto-seek 
or an auto-scan. 


The read verify command scans the data in the specified number of sectors of 
the selected drive. As the hard disk controller scans the data of each sector, it 
calculates the ECC bytes and verifies that the ECC bytes calculated from the 
data and ECC bytes read from the disk agree. If the heads are not positioned 
at the specified cylinder, the controller performs an implied seek to the proper 
cylinder. The step rate used is that of the most recently executed restore or 
seek command. Multiple sector reads may cross head and cylinder boundaries. 

If the DRIVE READY signal becomes inactive, or the WRITE FAULT signal 
becomes active, the hard disk controller terminates the command and sets 
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ABORTED COMMAND DETECT (error register bit 2) and ERROR (status 
register bit 0). 

To indicate command completion or an error condition, the hard disk controller 
generates an interrupt request to the CPU. 
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Diagnose Command 


76543210 



■n i-1 i-1 l 

DIAGNOSE COMMAND 

-1- 
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0 0 

1 

Bit 

Description 


7-0 

DIAGNOSE COMMAND (Always 10010000) 



On receipt of this command, the hard disk controller executes a set of diag¬ 
nostic tests. If a problem exists, the hard disk controller reports the results in 
the error register (see Table 12-4). The internal ROM, internal RAM, ECC cir¬ 
cuitry, and data path circuitry are tested. When the diagnostic tests complete, 
the hard disk controller loads the appropriate code into the error register. To 
indicate command completion, the hard disk controller generates an interrupt 
request to the CPU. 

For the diagnose command, the code in the error register is interpreted dif¬ 
ferently than normal error register encoding. Table 12-4 lists the diagnose com¬ 
mand result codes. 

Table 12-4 Hard Disk Controller Diagnostic Result Codes 


Value Meaning 

01H No error 

02H WD1015/WD2010 controller error 

03 H Sector Buffer RAM data error 

04H WD1015/WD11C00A-22 Register access error 

05H WD1015 ROM checksum or RAM data error 
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Bit Description 

7-0 SET PARAMETERS COMMAND (Always 10010001) 


This command sets the drive parameters for the maximum number of heads 
and sectors per track. Prior to issuing this command, the drive selection must 
be specified in the Sector Size/Drive Select/Head Select task register, and the 
Sector Count Register must be set. This command must be issued before any 
multiple sector operations are performed. To indicate command completion, the 
hard disk controller generates an interrupt request to the CPU. 
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Status Register (01F7H/0177H) 
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Bit R/W Description 

7 R BUSY 

0 = Hard disk controller is ready to accept commands. The 
status and error registers contain valid data. 

1 = Hard disk controller is busy. The error register contains 
invalid data. Only this status register bit is valid. 

This bit must be polled before reading any register. 

6 R DRIVE READY 

0 = Drive is not ready. Read, write, and seek commands are 
inhibited. 

1 = Drive is ready. If bit 4 equals 1, read, write, and seek 
commands are possible. 

5 R WRITE FAULT 

0 = No error 

1 = Improper operation of the drive. All commands will be 
terminated with an aborted command error. 

4 R SEEK STATUS - Seek Complete 

0 = Seek operation, direct or implied, is incomplete. 

1 = Seek operation is complete (read/write heads are in position). 

3 R DRQ - Data Request 

0 = Do not read or write the sector buffer 

1 = Read or write the sector buffer as indicated by the last 
command issued. 

2 R CD - Corrected Data 

0 = No error 

1 = The sector read from the drive resulted in a correctable ECC 
error. Correctable errors do not cause multiple sector 
transfers to terminate. 
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Bit R/W Description (Status Register - cont.) 

1 R INDEX 

0 = Index not in position and not detected 
1 = Index In position and detected 

0 R ERROR 

0 = No error 

1 = A nonrecoverable error has occurred. The error register coil- 
tains the error status. 

The next command issued to the hard disk controller, clears this 
bit. If the hard disk controller sets this bit during a multiple sector 
transfer, the transfer is terminated. 


12- 24 Hard Disk Drive Controller - Hardware Description 





Alternate Status Register (03F6H/0376H) 

This read-only register duplicates the status register (01F7H/0177H). 

Hard Disk Register (03F6H/0376H) 
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Bit R/W Description 


7-4 W 
3 W 


2 W 


1 W 


0 W 


Always 0 

ENABLE HEAD SELECT BIT 3 

0 = Reduced write current enabled 

1 = Head Select Bit 3 (SDH register bit 31 enabled. See the 
SDH register description. 

RESET 

0 = Hard disk controller enabled. 

1 = When set, the hard disk controller enters the reset state and 
remains there until this bit is cleared. This bit must stay set 
for a minimum of 5 /us. When this bit is cleared, the hard 
disk controller performs a set of power-up diagnostic tests 
and the busy bit (status register bit 7) remains set until tests 
are completed. 

INTRPT ENABLE - Interrupt Enable 

0 = Hard disk controller interrupt buffer is enabled. Setting this 
bit does not clear the hard disk controller interrupt output. 
When this bit is cleared, any pending interrupts will occur. 

1 = Hard disk controller interrupt buffer is disabled. 

This bit enables or disables a buffer between the hard disk control¬ 
ler output and the peripheral interrupt controller input. 

Always 0 
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Digital Input Register (03F7H/0377H) 
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SELECT 
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SIGNAL 

SIGNAL 

SIGNAL 

SIGNAL 



1 

2 

1 

0 

1 
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Bit 

R/W 

Description 

7 

R 

Reserved (Value undefined) 

6 

R 

WRITE GATE SIGNAL 

0 = Write gate signal is active. 

1 = Write gate signal is inactive. 

5 

R 

Always 1 

4 

R 

HEAD SELECT SIGNAL 2 

0 = Head select signal 2 is active. 

1 = Head select signal 2 is inactive. 

3 

R 

HEAD SELECT SIGNAL 1 

0 = Head select signal 1 is active. 

1 = Head select signal 1 is inactive. 

2 

R 

HEAD SELECT SIGNAL 0 

0 = Head select signal 0 is active. 

1 = Head select signal 0 is inactive. 

1 

R 

DRIVE SELECT SIGNAL 1 

0 = Drive select signal 1 is active. 

1 = Drive select signal 1 is inactive. 

0 

R 

DRIVE SELECT SIGNAL 0 

0 = Drive select signal 0 is active. 

1 = Drive select signal 0 is inactive. 
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Programming Example 

The following programming example demonstrates: 

• Initializing the hard disk controller 

• Recalibrating the hard disk drive 

• Seeking to a track 

• Hard formatting a hard disk 

CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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#include "kyb.h" 
#include "example.h H 


/ft**********************************************************************/ 

/* define constants used in hard disk controller example */ 
/***********************************************************************/ 
#define PRI_BASE OxOlfO /* primary base address of controller regs */ 
#define ALTLBASE 0x0170/* alternate base address of controller regs */ 


#define HDR_ASR 0x03f6 

#define DIG.INP 0x03f7 


/* address of hard disk register */ 
/* and alternate status register */ 
/* address of digital input register */ 


/* define constant divisor for write precompensation cylinder */ 


#define WPC_DIV 0x04 


/* define bit values for error status register */ 


#define 

ERR.BBD 

0x80 

#define 

ERR_DFE 

0x40 

#define 

ERR^ID 

0x10 

#define 

ERR.ABR 

0x04 

#define 

ERR.TZE 

0x02 

#define 

ERR.DAMNF 

0x01 


/* bad block detected */ 
/* CRC/ECC error in data field */ 
/* could not locate correct ID field */ 
/* command aborted */ 
/* track zero error */ 
/* data address mark not found */ 


/* define bit values for hard disk register */ 


#define HEAD_SEL3 0x04 
#define RESET_HDC 0x02 
#define INT_ENA 0x01 


/* enables third head select bit */ 
/* resets hard disk controller */ 
/* enables hdc interrupts to CPU */ 


/* define bit values for sdh register */ 


#define SDH_ECC 0x80 


/* select ecc mode for data 


field */ 


#define SDH.256 0x00 

#define SDH_512 0x20 


/* sector size = 256 */ 
/* sector size * 512 */ 
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/* define bit values for status register */ 


#define 

STATJBSY 

0x80 


/* hdc busy */ 

#define 

STAT_RDY 

0x40 


/* drdy pin */ 

#define 

STAT.WF 

0x20 


/* write fault */ 

#define 

STAT.SC 

0x10 


/* seek complete */ 

#define 

STAT_DRQ 

0x08 


/* data request */ 

#define 

STAT_DWC 

0x04 

h 

c data was corrected */ 

#define 

STAT_ERR 

0x01 

/* nonrecoverable error */ 

/* define bit values for 

command register */ 


#define 

SR_35US 

0x00 

/* step rate * 35 us */ 

#define 

SR_0_5MS 

0x01 

/* 

step rate = 0.5 ms */ 

#define 

SR_1_0MS 

0x02 

/* 

step rate * 1.0 ms */ 

#define 

SR_1_5MS 

0x03 

/* 

step rate = 1.5 ms */ 

#define 

SR_2_0MS 

0x04 

/* 

step rate = 2.0 ms */ 

#define 

SR_2_5MS 

0x05 

/* 

step rate * 2.5 ms */ 

#define 

SR_3_0MS 

0x06 

/* 

step rate = 3.0 ms */ 

#define 

SR_3_5MS 

0x07 

/* 

step rate = 3.5 ms */ 

#define 

SR_4_0MS 

0x08 

/* 

step rate = 4.0 ms */ 

#define 

SR_4_5MS 

0x09 

/* 

step rate 88 4.5 ms */ 

#define 

SR_5_0MS 

0x0a 

/* 

step rate = 5.0 ms */ 

#define 

SR_5_5MS 

0x0b 

/* 

step rate = 5.5 ms */ 

#def ine 

SR_6__0MS 

0x0c 

/* 

step rate * 6.0 ms */ 

#define 

SR_6_5MS 

OxOd 

/* 

step rate = 6.5 ms */ 

#define 

SR_3_2US 

OxOe 

/* 

step rate = 3.2 us */ 

#define 

SR_1_6US 

OxOf 

/* 

step rate = 1.6 us */ 

#define 

CMD_IC 

0x08 

/* 

: interrupt control */ 

#define 

CMD_MSF 

0x04 

/* multiple sector flag */ 

#define 

CMD_LM 

0x02 

/* long mode read and write */ 

#define 

CMD^TRY 

0x01 


/* disable retries */ 

#define 

CMD_REST 

0x10 


/* restore command */ 

#define 

CMD_SEEK 

0x70 


/* seek command */ 

#define 

CMD_READ 

0x20 


/* read command */ 

#define 

CMD_WRITE 

0x30 


/* write command */ 

#def ine 

CMD.SCAN 

0x40 

/* read/verify command */ 

#define 

CMD_FRMAT 

0x50 


/* format command */ 

#define 

CMD_CC 

0x08 

/* compute 

correction command */ 

#def ine 

CMD_PARM 

0x91 

/* set parameter command */ 
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y'***********************************************************************/ 

/* declare structures used in hard disk controller example */ 

/ft********************************************** He***********************/ 


typedef struct 
i 

unsigned char sec.buf; 
unsigned char err_wpc; 


unsigned char sc; 
unsigned char sn; 
unsigned char cyl_low; 
unsigned char cyl_hi; 
unsigned char sdh; 
unsigned char csr; 

> HDC; 


/* (R/W) sector buffer */ 
/* (R) error reg */ 
/* (W) write precompensation cylinder */ 
/* (R/W) sector count */ 
/* (R/W) sector number */ 
/* (R/W) lower 8 bits of cylinder number */ 
/* (R/W) upper 2 bits of cylinder number */ 
/* (R/W) sdh register */ 
/* (R) status reg, (W) command reg */ 


typedef struct 

HDC *base; /* primary 
int busy; 
int retry; 
unsigned int cyl; 
unsigned char last.cmd; 
unsigned char ecm; 
unsigned char srt; 
unsigned char ds; 
unsigned char hs; 
unsigned char sc; 
unsigned char sn; 
unsigned char eot; 
unsigned char fgpl; 
unsigned char nd; 
unsigned char ss; 
unsigned char t; 

> HDC_CMD; 


or alternate base address of controller reg */ 

/* busy flag */ 
/* retry count */ 
/* cylinder number */ 
/* last command sent to hdc */ 
/* error correction method */ 
/* step rate time */ 
/* drive select 0 ~ 3 */ 
/* selected head number */ 
/* sector count */ 
/* sector number */ 
/* end of track */ 
/* format gap length */ 
/* non-DMA mode */ 
/* sector size */ 
/* retry flag */ 
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typedef struct 

unsigned int cc; 
unsigned int wpc; 
unsigned int he; 
unsigned int spt; 

> HDD ; 

typedef struct 

unsigned int cyl; 
unsigned char error; 
unsigned char sc; 
unsigned char sn; 
unsigned char sdh; 
unsigned char status; 

> HDC.RESULT; 


/* cylinder count */ 
/* write precompensation cylinder */ 
/* head count */ 
/* sectors per track */ 


/* cylinder number */ 
/* error code/status */ 
/* sector count */ 
/* sector number */ 
/* sdh register */ 
/* status register */ 


/***********************************************************************/ 
/* declare space for hdc parameter data */ 

/***********************************************************************/ 

HDD hdd[2] = /* hard disk descriptors */ 

i 

{ 615, 300, 4, 17 >, 

{ 615, 300, 4, 17 >, 

>; 

HDC_CMD hdc.cmd; /* command data */ 

HDCLRESULT hdc.result; /* result data */ 

int hdc.buff[256]; /* hdc I/O buffer */ 


/;|c$***************:****:*****************3ic**$3fc******’|e’l‘****:tc$****’l'**$*’|(’l'’l'**/ 

/* hds() - select the desired drive */ 

/sk**********************************************************************/ 

hds() /* select error correction method, sector size, drive, and head */ 

•C 

HDC *phdc = hdc_cmd.base; /* pointer to controller registers */ 

outp(&phdc->sdh, hdc.cmd.ecm | hdc.cmd.ss I (hdc.cmd.ds << 4) | hdc.cmd.hs); 

> 
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/***********************************************************************/ 

/* waitjhdc() - wait for hard disk command to complete */ 

/**5fc*:4::fc:4:*5je>|e*H<***********H«*****5!<:fc**********:fcs|c*****:fc*5k****5|«**:fc***’l«>f<5|<**5|<*5|<sJ</ 

wait_hdc() 

{ 

HDC *phdc = hdc_.cmd.base; /* pointer to controller registers */ 

while(hdc_cmd.busy) /* wait until interrupt occurs */ 

; /* busy bit should be clear, but just in case, */ 

while(inp(Aphdc->csr) & STATJBSY) /* wait until busy bit is clear */ 

» 

if(inp(&phdc->csr) k STAT_ERR) /* if error condition */ 

hdc_result.error ■ inp(&phdc->err_wpc); /* read error register */ 

else hdc_result.error =0; /* mark no error */ 

switch(hdc_cmd.last_cmd) /* discover last command issued */ 

{ 

case CMD_REST : 

while((inp(*phdc->csr) k (STAT.RDY | STAT_SC)) !~ (STAT_RDY I STAT.SC)) 

i 

break; 

case CMD_SEEK : 

while((inp(&phdc->csr) k (STAT_RDY | STAT_SC)) != (STAT_RDY | STATIC)) 
break; 

case CMD.FRMAT: 
break; 

default : 
break; 

> 

hdc_result.se = inp(ftphdc->sc); /* read sector count register */ 

hdc_result.sn = inp(&phdc-‘>sn); /* read sector number register */ 

hdc_result.cyl = inp(Aphdc->cyl_low); /* low 8 bits of cyl */ 

hdc_result.cyl |= inp(&phdc->cyl_hi) « 8; /* high 2 bits of cyl */ 

hdc_result.sdh = inp(Aphdc->sdh); /* read sdh register */ 

hdc_result.status = inp(&phdc->csr); /* read status register */ 

dspjhdc_stat(); /* display result status */ 

> 
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/***********************************************************************/ 
/* hdc.issue() * issue all hdc commands */ 

/***********************************************************************/ 

hdc.issue(cmd) 

int cmd; /* desired command */ 

i 

HDC *phdc * hdc.cmd.base; 
char oline[20]; 

hdc.cmd.last.cmd * cmd; 
switch(cmd) 

i 

case CMD.REST: 
hdc.cmd.cyl * 0; 
hdc.cmd.hs = 0; 
cmd |= hdc.cmd.srt; 
break; 

case CMD.SEEK: 

cmd |= hdc.cmd.srt; 
break; 

case CMD.SCAN: 

cmd |= hdc.cmd.t; 
break; 

case CMD.READ: 

case CMD.WRITE: 
break; 

default: 
break; 

> 

outp(Aphdc->err.wpc, hddfhdc.cmd.ds].wpc » 2); /* write the wpc reg */ 
outp(Aphdc->sc, hdc.cmd.sc); /* write the sector count */ 

outp(&phdc->sn, hdc.cmd.sn); /* write the sector number */ 

outp(&phdc->cyl_low, hdc.cmd.cyl); /* write 8 low bits */ 

outp(Aphdc->cyl.hi, hdc.cmd.cyl » 8); /* write 2 high bits */ 

hds(); /* select appropriate drive */ 

outp(Aphdc->csr, cmd); /* write the command */ 

hdc.cmd.busy = TRUE; 

> 


/* read data ? */ 
/* write data ? */ 


/* read ID ? */ 
/* scan id command */ 


/* seek ? */ 
/* seek command */ 


/* set last command issued */ 


/* recalibrate ? */ 


/* restore command */ 
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/***********************************************************************/ 
/* hdc_init() - initialize hard disk controller and interrupt vector */ 
/***********************************************************************/ 

hdc_init() 

{ 


outp(HDR_ASR, RESETJHDC); 

iv_init(0x76); 
imask(l, 6, ON); 
outp(HDR_ASR, INTJENA); 


/* reset the hdc */ 
/* must be reset for minimum of 5 us */ 
/* initialize the interrupt vector */ 
/* enable PIC input */ 
/* hdc not reset and allow interrupt */ 


/* hdc_rest() - restore hard disk controller and interrupt vector */ 

/***********************************************************************/ 


hdc_rest() 

i 

outp(HDR_ASR, RESEUHDC); 
imask(l, 6, OFF); 
iv_rest(0x76); 
outp(HDR_ASR, INT.ENA); 


/* reset the hdc */ 
/* disable PIC input */ 
/* restore the interrupt vector */ 
/* hdc not reset and allow interrupt */ 


/*3ic*)|ej|c)|c*:>|c*********9|e***:ic**************3|«********3i<>|c*>|c9|c)|e9i()ie3i'*9|c*’l‘**3|e*)l‘*>l‘3|e:|c9ic*)|'*/ 

/* hdc__int_hand() - hdc interrupt handler */ 

/***********************************************************************/ 

hdc_int_hand() 

{ 

HDC *phdc = hdc_cmd.base; /* pointer to controller registers */ 

hdc_result.status = inp(fcphdc->csr); /* read status register */ 

hdc_cmd.busy = FALSE; /* no longer busy */ 

eoi(l); 

> 
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/***********************************************************************/ 
/* hdc() - execute hard disk controller examples */ 

y*****s(c*3t:*^**** + + *He****** + *****4:*3|i:***54t*********5|i:****5|«5l | :*5f:**5k*3f:*5(c**5|«5te**** + / 

hdc() 

{ 

static MESSAGE mhdc[] = /* hdc menu */ 

< 

{ 3, 27, "Hard Disk Controller Example" >, 

{ 5, 27, "FI. Recalibrate" >, 

{ 6, 27, "F2. Head +" >, 

{ 7, 27, "F3. Head -" >, 

i 8, 27, "F4. Seek +" >, 

{ 9, 27, "F5. Seek -" >, 

{ 10, 27, "F6. Read ID" >, 

{ 11, 27, "F7. ** Format Disk ** (Erases data)" >, 

{ 12, 27, "F10. Return to Main menu" >, 

{ 0 , 0 , 0 >, 

>; 

char line[512]; 
char oline[512]; 
unsigned int cyl; 
unsigned int head; 

HDC *phdc; 
int *pi; 
int i; 

disp_menu(mhdc); 
hdc_cmd.base = (HDC *)PRI_BASE; 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.ss = SDH_512; 
hdc_cmd.ds = 0; 
hdc_cmd.hs = hdd[0].hc; 
hdc_cmd.sc = hdd[0].spt; 
hdc_cmd.srt = SR_1_5MS; 
phdc = hdc_cmd.base; 
hdc _is sue(CMD_PARM); 
wait_hdc(); 

hdc_cmd.cyl = hdc ..result. cyl; 
dsp_hdc_stat(); 
hdc_cmd.hs = 0; 
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/* display the hdc menu */ 
/* controller addressed at primary */ 

/* assign step rate */ 
/* set parameters */ 


/* to hold input line */ 
/* to hold output line */ 
/* loop control */ 
/* loop control */ 



line[0] * 0; /* null terminated */ 

while(l) /* forever (see F10) */ 

{ 

line[0] = get_fkey(); /* get a function key for menu selection */ 
switch(line[0]) /* determine menu selection */ 

case FI: /* recalibrate */ 

hdc.cmd.ecm = SDHJECC; 
hdc_cmd.se - hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = 0; 
hdc_issue(CMD_REST); 

wait_hdc(); /* wait for command complete */ 

break; 

case F2: /* head select + 1 */ 

hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = 0; 

if(hdc.cmd.hs < hdd[hdc_cmd.ds].he) hdc_cmd.hs++; 
if(hdc_cmd.hs == hdd[hdc_cmd.ds].he) hdc_cmd.hs—; 
hdc_issue(CMD_SEEK); 

wait_hdc(); /* wait for command complete */ 

break; 

case F3: /* head select -1 */ 

hdc_cmd.ecm - SDH.ECC; 
hdc_cmd.se * hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn * 0; 
if(hdc_cmd.hs) hdc_cmd.hs—; 
hdc_issue(CMD_SEEK); 

wait_hdc(); /* wait for command complete */ 

break; 

case F4: /* seek + 1 cylinder */ 

hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc.cmd.sn * 0; 

if(hdc_cmd.cyl < hdd[hdc_cmd.ds].cc) hdc_cmd.cyl++; 
if(hdc_cmd.cyl == hdd[hdc_cmd.de].cc) hdc_cmd.cyl—; 
hdc_issue(CMD_SEEK); 

wait_hdc(); /* wait for command complete */ 

break; 
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/* seek - 1 cylinder */ 


case F6: 

hdc_cmd.ecm = SDHJECC; 
hdc^cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = 0; 

if(hdc_cmd.cyl) hdc_cmd.cyl--; 
hdc_issue(CMD_SEEK); 
wait_hdc(); /* wait for command complete */ 

break; 

case F6: /* scan id */ 

hdc_cmd.ecm » SDH_ECC; 
hdc_cmd.se = 1; 

for(i = 1; i <= hdd[hdc_cmd.ds].spt; i++) 

hdc_cmd.sn = i; 
hdc_issue(CMD_SCAN); 

wait_hdc(); /* wait for command complete */ 

> 

break; 

case F7: /* hard format disk */ 

hdc_is8ue(CMD_REST); 

wait_hdc(); /* wait for command complete */ 

interleave(hdc_buff, 256, 17, 2, Oxffff); 

for(cyl = 0; cyl < hdd[hdc_cmd.ds].cc; cyl++) /* all cylinders */ 

hdc_cmd.cyl = cyl; /* current cylinder */ 

for(head = 0; head < hdd[hdc_cmd.ds].he; head++)/* all heads */ 

i 

hdc_cmd.hs = head; 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn =0; 

hdc_issue(CMD_SEEK); /* seek to current cylinder */ 

wait_hdc(); /* wait for command complete */ 

hdc_cmd.ecm = SDH_ECC; 

hdc_cmd.se = hdd[hdc.cmd.ds].spt; 

hdc_cmd.sn = 0; 

hdc.issue(CMD_FRMAT); 

while(!(inp(&phdc->csr) ft STAT_DRQ)) 

» 

for(i = 0; i < 256; i++) 

outw(ftphdc->8ec_buf, hdc_buff[i]); 
wait_hdc(); /* wait for command complete */ 

> 

> 

break; 
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case F8: 

interleave(hdc_buff, 256, 17, 2, Oxffff); 
for(cyl = 0, head = 0; head < 30; head++) 

sprintf (oline, ,,# / 0 O4x M , hdc_buf f [head] ) ; 
disp_str(13 + (head / 10), (head % 10) * 5, oline); 

> 

break; 

case F10: /* return to caller (main menu) */ 

return; 

> 

> 

> 


dsp_hdc_stat() 

HDCLRESULT *pres = &hdc_result; 
char oline[50]; 


sprintf(oline, "Error Reg 
disp__str(21, 1, oline); 

sprintf(oline, "Sector Count : 
disp_str(21, 41, oline); 
sprintf(oline, "Sector Number: 
disp_str(22, 1, oline); 
sprintf(oline, "Cylinder Num : 
disp__str(22, 41, oline); 
sprintf(oline, "SDH Register : 
disp_str(23, 1, oline); 
sprintf(oline, "Status Reg 
disp_str(23, 41, oline); 
sprintf(oline, "Last command : 
disp_str(24, 1, oline); 

> 


Ox°/ 0 O2x", pres->error) ; 
0x%02x", pres->sc); 

Ox°/ 0 O2x", pres->sn) ; 

0x%04x", pres->cyl); 

Ox°/ 0 O2x", pres->sdh) ; 

Ox°/ 0 O2x", pres->status) ; 
Ox°/ 0 O2x" , hdc^cmd. last_cmd) ; 
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interleave(pb, size, cnt, il, fill) 


int *pb; 
int size; 
int cnt; 
int il; 
int fill; 

int *pi; 
int *pf; 
int x, y; 

x = size - cnt; 
pf = pi = pb + cnt; 
while(x--) *pi++ = fill; 
for(x =1; x <= cnt; x++) 

l 

if(pi > pf) pi ■ pb++; 

*pi++ = x « 8; 

for(y - 1; y < il; y++) pi++; 

> 


/* pointer to buffer */ 
/* size of buffer */ 
/* number of sectors */ 
/* interleave:1 */ 
/* fill byte */ 


/* temp pointer */ 
/* start of fill */ 
/* temp counter */ 

/* fill size */ 
/* offset to fill */ 
/* set fill bytes */ 


> 
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Chapter 13 
Network Hardware Interface 


Introduction to the LANCE 

The network hardware interface is located on the VAXmate workstation I/O 
board. When the back of the VAXmate workstation is open and no options are 
plugged in, the I/O board is visible. 

VAXmate workstations may contain different versions of the LANCE, which 
exhibit subtle differences on large networks with high levels of traffic. The dif¬ 
ferent versions of hardware require special treatment by software. Digital 
Equipment Corporation recommends that you avoid programming the hardware 
interface directly. Instead, applications should use the MS-Network session 
level interface, DECnet-DOS session level interface, and the Data Link inter¬ 
face to access the network. For additionl information about these software in¬ 
terfaces, see Chapter 18 in this manual. 

The remainder of this chapter discusses the following topics: 

• Functional description of the Network Hardware Interface 

• Programming sequence 

• Register descriptions 

• Physical description 

• Physical address field 

• Logical address filter field 

• Buffer management 

• Receive descriptor rings 

• Transmit descriptor rings 

• Network interface external interconnect 

• Network Interface system bus interconnect 




Additional Source of Information 

Additional information about the LANCE can be found in the 
Advanced Micro Devices document: 

• MOS Microprocessors and Peripherals 1985 Data Book 

Functional Description of the Network 
Hardware Interface 

The network hardware interface is connected to the system bus. The interface 
contains address, data, and control lines capable of handling the controller func¬ 
tions. The interface is part of the standard communications and I/O functions 
of the VAXmate workstation. 

The Network Interface (Nil consists of three main integrated circuits. The 
hardware also includes a small number of discrete components, system bus in¬ 
terfacing devices, and a female BNC connector mounted directly on VAXmate 
I/O module printed circuit board. The BNC connector connects the Network 
Interface to the network. 

The three integrated circuits in the NI are the: 

• Coax Transceiver Interface (CTI) 

• Serial Interface Adapter (SIA) 

• Local Area Network Controller for Ethernet (LANCE) 

The Coax Transceiver Interface 

The CTI interfaces to the coaxial cable by a BNC connector. The CTI performs 
transmit, receive, and collision detect functions for the network controller. The 
CTI is electrically isolated from the other devices as required by IEEE 802.3 
specifications. 

The Serial Interface Adapter 

The SIA interfaces to the CTI through an isolation transformer. The SIA per¬ 
forms manchester phase encoding and decoding of the data transferred over 
the network. The SIA also interfaces with the LANCE. The SIA filters noise 
and interprets collisions for the LANCE circuit. 

The Local Area Network Controller 

The LANCE converts data beteen the network serial format and the system 
byte-wide format. The LANCE is the primary interface between the network 
hardware and the rest of the VAXmate workstation. 
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In receive mode, the LANCE: 


1. Receives information from the SIA. 

2. Converts the serial network bit stream into a parallel (8-bit wide) byte 
stream. 

3. Strips the Ethernet preamble and synchronization pattern. 

4. Checks and removes the CRC bits. 

5. Uses direct memory access and a 24-bit-wide physical address to place 
the information in memory located in the CPU address space. 

In transmit mode, the LANCE: 

1. Uses DMA to read data from system memory. 

2. Converts the data to a serial bit stream. 

3. Adds a preamble and sync pattern. 

4. Calculates and adds the CRC at the end of the data packet. 

5. Passes the data packet to the SIA for transmission on the Thin Wire 
Ethernet. 


Programming the LANCE 

This section defines the control registers, status registers, and the data struc¬ 
tures that are used to program the hardware interface. 

The LANCE is controlled by a set of four control and status registers (CSRs) 
and three data structures. The CSRs are accessible within the CPU I/O address 
space and the data structures located in the CPU memory address space. After 
the LANCE is enabled, it acquires additional operating parameters by accessing 
the data structures. The LANCE accesses system memory through bus arbitra¬ 
tion between the LANCE, CPU. memory refresh controller, and the DMA 
controller. 

After the LANCE is programmed, it independently manages the data struc¬ 
tures and transfers data packets on the Thin Wire Ethernet. 

The three data structures accessed by the LANCE are: 

• Initialization Block 

• Receive and Transmit Descriptor Rings 

• Data Buffers 
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Initialization Block 

The initialization block is 12 contiguous words of memory starting on a word 
boundary. The controlling program stores the operating parameters in the in¬ 
itialization block. To acquire the operating parameters, which are necessary for 
device operation, the LANCE reads the initialization block. The initialization 
block contains the: 

• Mode of Operation 

• Physical Address 

• Logical Address Mask 

• Location of Receive and Transmit Descriptor Rings 

• Number of Entries in Receive and Transmit Descriptor Rings 

Receive and Transmit Descriptor Rings 

The receive and transmit descriptor rings are two ring structures: one for in¬ 
coming and the other for outgoing packets. Each entry in the rings is four 
words, and must start on a quadword boundary. The descriptor rings contain 
the buffer address, length, and status. 

Data Buffers 

Data buffers are contiguous portions of memory reserved for buffering packets. 
Data buffers can begin on arbitrary byte boundaries. Entries in the Receive and 
Transmit Descriptor Rings point to the data buffers. 

Programming Sequence 

The general programming sequence of the LANCE is: 

1. Load CSR1 and CSR2, which identifies the location of an initialization 
block in memory. 

2. Load CSR3, which sets the operating mode of the LANCE. 

3. Set the INIT and STRT bits in CSRO, which causes the LANCE to 
load the information from the initialization block and to access the 
descriptor rings. 

NOTE 

The ThinWire Ethernet interface conforms to the IEEE 802.3 
specification, which requires a frequency accuracy of ±0.01%. 

The crystal oscillator in the VAXmate network hardware re¬ 
quires 1 Ms after power on to achieve ±10% accuracy, and 10 
seconds to achieve ±0.01% accuracy. Therefore, the network in¬ 
terface is considered operational 10 seconds after power-on of 
the VAXmate workstation. 

On powerup, the VAXmate diagnostics ensure the required 10 
second settling time. 
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Register Description 

The Network Interface uses three physical I/O ports as registers: two in the 
LANCE, and one in the interface logic. The registers in the LANCE comprise 
five logical registers, for a total of six logical registers in the Network Interface 
(NI). 

The LANCE internal CSEs are accessed through its two bus addressable ports, 
a register address port (RAP), and a register data port (RDP). The internal 
CSRs are read (or written) in a two step operation. The address of the CSR is 
written into the address port (RAP). Then the data is read from (or written 
into) the selected CSR through the RDP. Once written, the address in RAP 
remains unchanged until rewritten. 

Table 13-1 describes the registers and their addressing. 


Table 13-1 Network Interface Registers 


Primary 

I/O 

Address 

Alias 

I/O 

Address 

R/W 

Register 

Width 

Description 

0C60H 

C064H 

R/W 

16-bit 

LANCE Register Data 
Port (RDP) 

0C62H 

C066H 

R/W 

16-bit 

LANCE Register Address 
Port (RAP) 

RAP = 0 


R/W 

16-bit 

LANCE CSR 0 

RAP = 1 


R/W 

16-bit 

LANCE CSR 1 

RAP = 2 


R/W 

16-bit 

LANCE CSR 2 

RAP = 3 


R/W 

16-bit 

LANCE CSR 3 

0C68H 

0C69H-0C6FH 

W 

8-bit 

NI CSR 


The logical address is the contents of RAP bits 1-0, and applies to references 
to LANCE internal CSR registers 3-0. These registers are physically addressed 
at the LANCE RDP address on the VAXmate I/O bus, and individually se¬ 
lected by the contents of LANCE RAP bits 1-0. 

The VAXmate address decode logic creates alias I/O port addresses for certain 
registers. The alias I/O addresses are listed in Table 13-1. 

NOTE 

Because future revisions of hardware may not implement thesfe 
aliases, programs should not use the alias addresses. 
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Register Data Port (RDP) 


15 


14 

13 

12 

11 

10 


9 

8 


1 

1 


1 

1 

1 

1 

" ' 1" 






CSR DATA 






| 

1 


1 

1 

1 

| 

1 


7 


6 

5 

4 

3 

2 


1 

0 


1 

* 


i 

1 

i 

i 

1 






CSR DATA 






_L_ 

_L_ 


_J_ 

_J_ 

_J_ 

.. 1 .. 

1 



Bit R/W Description 


15-0 R CSR DATA 

Writing data into RDP writes the data into the CSR selected in 
RAP. Reading the data from RDP reads the data from the CSR 
selected in RAP. CSR1, CSR2, and CSR3 are accessible only when 
the STOP bit of CSRO is set. 

If the STOP bit is not set while attempting to access CSR1, 

CSR2, or CSR3, the LANCE returns READY, but a read opera¬ 
tion returns undefined data and a write operation is ignored. 
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11 


10 


9 


8 


Register Address Port (RAP) 

15 14 13 12 

- 1 - 1 - 1 -r~ 

RES 

_I_I_I_I_I I_L 

7 6 5 4 3 2 

-1-1-1-1-1- 

RES 

_I_I_I_I_I_ 

Bit R/W Description 

15-2 RES - Reserved (always 0) 

1-0 R/W CSR - Control/Status Register Select 
0 = CSRO accessed through RDP 

1 = CSR1 accessed through RDP 

2 = CSR2 accessed through RDP 

3 — CSR3 accessed through RDP 

The register address port is cleared by STOP or Bus RESET. 
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9 


8 


Control And Status Register 0 (RAP = 0 ) 

15 14 13 12 11 10 


ERR 

BABL 

CERR 

HISS 


RINT 

TINT 

I DON 

76543210 

INTR 

INEA 

RXON 

TXON 

g 

STOP 

STRT 

INIT 

Bit R/W Description 


15 E ERR - Error 


0 = The four bits BABL, CERR, MISS and MERR are all equal 
to 0. 

1 = One or more of the four bits, BABL, CERR, MISS, or 
MERR are equal to 1. 

14 BABL - Babble 

R 0 = Less than 1519 bytes of data have been transmitted. 

1 = 1519 bytes of data, or more, have been transmitted. 

BABL indicates a transmitter error, caused by the transmitter 
being on longer than the time required to send the maximum 
length packet. The LANCE transmits data until the transmit 
buffer byte count equals 

zero. The LANCE assumes the Ethernet transmission is limited by 
the physical channel interface. 

If INEA = 1, an interrupt is generated when BABL is set. 

W 0 = No effect 

1 = Clears this bit 

Bable is read/clear only. BABLE is cleared by Bus RESET or set¬ 
ting the STOP bit. 
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Bit R/W Description (CSRO - cont.) 


13 


R 


W 


12 


R 


W 


11 


R 


W 


CERR - Collision Error 
0 = No collision error 
1 = Collision error 

The collision input failed to activate within 2 fis after a 
transmission, started by the controller, was completed. Collision 
after transmission is a test feature of the transceiver. 

0 = No effect 
1 = Clears this bit 

CERR is READ/CLEAR ONLY 

CERR is cleared by Bus RESET or setting the STOP bit. 

MISS - Missed Packet 

0 = Receiver owns a receive buffer or the SILO has not 
overflowed 

1 = The receiver loses a packet because it does not own a receive 
buffer and the SILO has overflowed, indicating loss of data. 
SILO overflow is not reported because there is no receive 
ring entry in which to write the status. 

0 = No effect 
1 = Clears the bit 

If INEA equals 1 and MISS equals 1, an interrupt is generated. 

MISS is READ/CLEAR ONLY. MISS is cleared by Bus RESET 
or setting the STOP bit. 

MERR - Memory Error 
0 = No memory error 

1 = LANCE is the Bus Master and has not received READY 

within 25.6 n s after asserting the address on the DAL lines. 
When a Memory Error is detected, the receiver and 
transmitter are turned off and an interrupt is generated if 
INEA = 1. 

0 = No effect 
1 = Clears the bit 

MERR is READ/CLEAR ONLY. MERR is cleared by Bus RESET 
or setting the STOP bit. 
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Bit R/W Description (CSRO - cont.) 


10 RINT - Receiver Interrupt 

R 0 = No receiver interrupt 

1 = Receiver interrupt 

W 0 = No effect 

1 = Clears the bit 

RINT = 1 when the status for an entry in the Receive Descriptor 
Ring is updated. 

If INEA = 1, an interrupt is generated when RINT is set. 

RINT is READ/CLEAR ONLY 

RINT is cleared by Bus RESET or setting the STOP bit. 

9 TINT - Transmitter Interrupt 

R 0 = No transmitter interrupt 

1 = When the status for an entry in the Transmit Descriptor 
Ring is updated. 

W 0 = No effect 

1 = Clears the bit 

If INEA = 1, an interrupt is generated when TINT is set. 

TINT is READ/CLEAR ONLY 

TINT is cleared by Bus RESET or setting the STOP bit. 

8 R IDON - Initialization Done 

0 = Initialization procedure not completed 

1 = LANCE has completed the initialization procedure started by 
setting the INIT bit. When IDON is set, the LANCE has 
read the initialization block from memory and stored the new 
parameters. 

If INEA = 1, an interrupt is generated when IDON is set. 

IDON is READ/CLEAR ONLY 

W 0 = No effect 

1 = Clears the bit 

IDON is cleared by Bus RESET or setting the STOP bit. 

7 R INTR - Interrupt Flag 

0 = BABL, MISS, MERR, RINT, TINT, and IDON are all equal 
0 

1 = One or more of the following interrupt causing conditions 
has occurred: BABL, MISS, MERR, RINT, TINT, IDON. If 
INEA =1 and INTR =1 the INTR L I/O pin will be low. 

INTR is cleared by Bus RESET or setting the STOP bit. INTR is 
also cleared by clearing the conditions that caused the interrupt. 
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Bit R/W Description (CSRO - cont.) 


6 R/W INEA - Interrupt Enable 

0 = The INTR L I/O pin will be high, regardless of the state of 
INTR. 

1 = If INTR =1, the INTR L I/O pin will be low. 

INEA allows the INTR L I/O pin to be driven low when the 
Interrupt Flag is set. If INEA =0 INEA is cleared by Bus RESET 
or setting the STOP bit. 

5 R RXON - Receiver ON 

0 = Receiver disabled 
1 = Receiver enabled 

RXON = 0 when IDON = 1, if DRX = 1 in the MODE register 
or a memory error (MERR =11 has occurred. RXON = 1 when 
STRT is set in CSRO, if DRX 0 in the MODE field of the initiali¬ 
zation block is IDON = 1. 

RXON is cleared by Bus RESET or setting the STOP bit. 

4 R TXON - Transmitter On 

0 = Transmitter enabled 
1 = Transmitter disabled 

When TXON = 0, IDON = 1, and DTX = 1 in the MODE regis¬ 
ter, an Underflow or Retry error has occurred during transmission 
or a memory error (MERR) has occurred. 

TXON = 1 when the INIT bit = 1, and when STRT =1 if DTX 
= 0 in the MODE register in the initialization block. TXON is 
cleared by Bus RESET or setting the STOP bit. 

3 W TDMD - Transmit Demand 

R 0 = The packet is sent subject to the 1.6-millisecond polling in¬ 
terval delay. 

1 = Packet is transmitted without the typical delay of the polling 
interval, 1.6 milliseconds. 

W 0 = No effect 

1 = Clears this bit 

TDMD, when set, causes the LANCE to access the Transmit 
Descriptor Ring without waiting for the poll time interval to 
elapse. TDMD need not be set to transmit a packet, it merely 
hastens the LANCE response to a Transmit Descriptor Ring entry 
insertion by the software. 

TDMD is cleared by Bus RESET or setting the STOP bit. TDMD 
is cleared by the LANCE after the Transmit Descriptor Ring is 
accessed. 
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Bit R/W Description (CSRO - cont.) 

2 R/W STOP 

0 = No effect 

1 = LANCE disabled from all external activity and internal logic 
cleared 

STOP set is the equivalent of asserting Bus RESET L. The 
LANCE remains inactive and STOP remains set until the STRT or 
INIT bit is set. If STRT, INIT, and STOP are all set together, 
STOP will override the other bits and only STOP will be set. Stop 
will terminate all LANCE activities asynchronously. 

STOP is cleared by setting INIT or STRT. 

1 R/W STRT - Start 

STRT enables the LANCE to send and receive packets, perform 
direct memory access and do buffer management. Setting STRT 
clears the STOP bit. If STRT and INIT are set together, the INIT 
function will be executed first. 

STRT is READ/WRITE WITH ONE ONLY. Writing a 0 into this 
bit has no effect. 

STRT is cleared by Bus RESET or setting the STOP bit. 

0 R/W INIT - Initialize 

0 = No effect 

1 = Starts LANCE initialization and reads initialization block. 
Setting INIT clears the STOP bit. 

If STRT and INIT are set together, the INIT function will be exe¬ 
cuted first. 

INIT is cleared by Bus RESET or setting the STOP bit. 
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9 


8 


Control And Status Register 1 (RAP = 1) 

15 14 13 12 11 10 




— i -1- 1 - 1 -1 

IADR(15-8) 

— 


1 1 

1 1 1 1 1 


7 

6 5 

4 3 2 1 

0 


1 1 

1 1 

i » 1 i 

IADR(7-1) 

1 1 1 1 

0 

Bit 

Description 



15-1 

0 

IADR 

The low-order 16 bits of the address of the first word (lowest ad¬ 
dress) in the initialization block. 

Always 0 


Accessible only when the STOP bit of CSRO equals 1. If STOP = 0, an access 
returns READY, a Read operation returns undefined data and a Write opera¬ 
tion is ignored. CSR1 is unaffected by Bus RESET L. 
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9 


8 


Control And Status Register 2 (RAP = 2) 

15 14 13 12 11 10 



15-8 RES 

Reserved. 

7-0 IADR (Bits 23-16) 

The high order 8 bits of the address of the first word of the in¬ 
itialization block. 


Accessible only when STOP equals 1 (CSRO). If STOP = 0, an access returns 
READY, a Read operation returns undefined data and a Write operation is 
ignored. 

CSR2 is unaffected by Bus RESET L. 
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9 


8 


Control And Status Register 3 (RAP = 3) 

15 1A 13 12 11 10 

-1-1-1-1-1- 1 -r 

RES 


J_I_I_I_I_I_ I 

6 5 4 3 2 1 0 


1-1-1-1- 

RES 

_1_1_1_1_ 

BSWP 

ACON 

BCON 


Bit R/W Description 

15-3 RES - Reserved (Always 0) 

2 R/W BSWP - Byte Swap 

0 = The LANCE does not swap high and low bytes 
1 = The LANCE swaps the high and low bytes on DMA data 
transfers between the SILO and bus memory. 

BSWP allows the LANCE to operate in systems that consider bits 
15-8 to be the least significant byte and bits 7-0 to be the most 
significant byte. Only data from Silo transfers is swapped, the in¬ 
itialization block data and the Ring Descriptor entries are NOT 
swapped. BSWP is cleared by Bus RESET or setting the STOP bit 
in CSRO. 

1 R/W ACON - ALE Control 

R/W 0 = ALE is asserted high. 

1 = ALE is asserted low. 

ACON defines the assertive state of ALE when the LANCE is a 
Bus Master. 

ACON is cleared by Bus RESET or setting the STOP bit in 
CSRO. 
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Bit R/W Description (CSR3 - cont.) 


0 R/W BCON - Byte Control 

BCON I/O Pin 16 I/O Pin 15 I/O Pin 17 

0 BM 1 L BM 0 L HOLD L 

1 BUSAKO L BYTE H BUSRQL 

BCON redefines the Byte Mask and Hold I/O pins. 

BCON is cleared by Bus RESET or setting the STOP bit in 
CSRO. 


Table 13-2 lists the value required for each function for CSR3. 

Table 13-2 LANCE CSR3 Required Values For The VAXmate Workstation 


Bit 

Function 

Value Required 

15-3 

Undefined 

should be zero 

2 

BSWP (Byte Swap) 

0 

1 

ACON (ALE Control) 

1 

0 

BCON (Byte Mask Control) 

0 


CSR3, which allows redefinition of the bus master interface, contains three 
bits. They are used to customize certain hardware interface signals provided by 
the LANCE when it is in bus master mode. The programming of these bits is 
hardware implementation dependent. The VAXmate workstation values are in 
Table 13-2. 

Accessible only when the STOP bit of CSRO equals 1. If STOP = 0, an access 
returns READY, a Read operation returns undefined data and a Write opera¬ 
tion is ignored. 

Bus RESET L or setting the STOP bit in CSRO, clears CSR3. 
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NI CSR (0C68H) 


7 

6 

5 

4 

3 

2 

1 

0 

LED 

RES 

RES 

LED 

INT 

RES 

RES 

INT 

SET 



CLEAR 

CLEAR 



SET 


Bit 

RIW 

Description 

7 

W 

LED SET - Diagnostic LED Indicator Set 

0 = No effect 

1 = LED on 

6 


RES - Reserved (undefined) 

5 


RES - Reserved (undefined) 

4 

w 

LED CLEAR - Diagnostic LED Indicator Clear 

0 = No effect 

1 = LED off (Power-on default) 

3 

w 

INT CLEAR - Network Interface Interrupt Enable Clear 

0 = No effect 

1 = Disable interrupts (Power-on default) 

2 


RES - Reserved (undefined) 

1 


RES - Reserved (undefined) 

0 

w 

INT SET - Network Interface Interrupt Enable Set 

0 = No effect 

1 = Enable interrupts 


The NI CSR supports individual bit-set and bit-clear capability in a write-only 
register. Writing a 1 to a bit invokes its particular set or clear operation on the 
designated function. Writing a 0 to a bit does not invoke the particular set or 
clear operation for the designated function. Writing 0 to both set and clear bits 
for a designated function leaves the state of that function unchanged. Because 
writing 1 to both the set and clear bits of a designated function will toggle the 
state of that function, writing 1 to both the set and clear bits is not 
recommended. 
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Initialization Block 

During initialization, the LANCE reads operating parameters from the initiali¬ 
zation block. 

When the INIT bit in CSRO is set, the LANCE begins reading the initialization 
block. To ensure proper parameter initialization and LANCE operation, the 
controlling program should set the INIT bit and then set the STRT bit. After 
the LANCE reads the initialization block, the LANCE sets IDON in CSRO and 
if INEA equals 1, the LANCE also generates an interrupt. 


Higher Addresses 

TLEN-TDRA (23-16) 

IADR +22 


TDRA (15-00) 

IADR +20 


RLEN-RDRA (23-16) 

IADR +18 


RDRA (15-00) 

IADR +16 


LADRF (63-48) 

IADR +14 


LADRF (47-32) 

IADR +12 


LADRF (31-16) 

IADR +10 


LADRF (15-00) 

IADR +08 


PADR (47-32) 

IADR +06 


PADR (31-16) 

IADR +04 


PADR (15-00) 

IADR +02 

Base Address of Block 

MODE (15-00) 

IADR +00 


The base address, BASE ADDR, is formed from CSR2 bits 7-0 and CSR1 bits 
15-1. 
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Mode Field 

(Initialization Block, Offset 00H) 


15 

14 

13 

12 

11 

10 

9 

8 

PROH 


1 

_1_ 

RES 

1 

_1_ 


7 

6 

5 

4 

3 

2 

1 

0 

RES 

INTL 

DRTY 

COLL 

DTCR 

LOOP 

DTX 

DRX 

Bit 

Description 







15 PROM - Promiscuous 

0 = Incoming packets matching physical or logical address filter 
are accepted. 

1 = All incoming packets are accepted. 

14-7 RES - Reserved 


6 


INTL - Internal Loopback 

INTL is used with the LOOP (bit 2) to determine where the loop- 
back is to be done. Internal loopback allows the LANCE to receive 
its own transmitted packet. The maximum transmit packet size al¬ 
lowed during loopback is 32 data bytes. The LANCE automatically 
adds 4 bytes of CRC to the packet if DTCRC=0 and therefore the 
receive packet could be 36 bytes. INTL is only valid if LOOP = 1, 
otherwise it is ignored. 


INTL Loop 
X 0 

0 1 

1 1 


LOOPBACK 

No loopback, normal operation 

external 

internal 
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Bit 


Description (Mode Field - cont.) 


5 DRTY - Disable Retry 

0 = LANCE attempts 15 retransmissions of a packet after the 
first collision before reporting a Retry error. 

1 = LANCE attempts only one transmission of a packet. If there 
is a collision on the first transmission attempt, a Retry Error 
(RTRY) is reported in Transmit Message Descriptor 3 
(TMD3). 

4 COLL - Force Collision 

0 = Collision not forced 

1 = Collision forced during subsequent transmission attempt 

COLL allows the collision logic to be tested. For COLL to be valid, 
the lance must be in internal loopback mode. When COLL = 1, 

16 transmissions are attempted, and a retry error is reported in 
TMD3. 

3 DTCR - Disable Transmit CRC 

0 = The transmitter generates and appends a CRC to the 
transmitted packet. 

1 = The CRC logic is allocated to the receiver and no CRC is 
generated and sent with the transmitted packet. 

During loopback, DTCR = 0 generates a CRC on the transmitted 
packet. CRC logic, shared by the receiver and the transmitter, 
cannot generate and check CRC at the same time. Therefore, the 
receiver does the CRC check. The generated CRC and data are 
written into memory and can be checked by the software. 

If DTCR = 1 during loopback, the software must append a CRC 
value to the transmit data in the transmit buffer. The receiver 
checks the CRC on the received data and reports any errors. 
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Bit 


Description (Mode Field - cont.) 


2 LOOP - Loopback 

0 = LANCE operates in normal mode 
1 = LANCE operates in full duplex mode for test purposes 

LOOP allows the LANCE to operate in full duplex loopback mode 
for test purposes. The maximum transmit packet size is limited to 
32 data bytes. The received packet may be 36 bytes because the 
LANCE automatically adds 4 CRC bytes if DTCRC=0. 

During loopback, the runt packet filter is disabled because the 
maximum packet is forced to be smaller than the minimum size 
Ethernet packet of 64 Bytes. 

LOOP = 1 allows simultaneous transmission and reception for a 
message constrained to fit within the SILO. The LANCE waits 
until the entire message is in the SILO before serial transmission 
begins. The incoming data stream fills the SILO from behind as it 
is being emptied. Moving the received message out of the SILO to 
memory does not begin until reception has ceased. In loopback 
mode, transmit data chaining is not possible. Receive data chaining 
is allowed, regardless of the receive buffer length. In normal opera¬ 
tion, not loopback, the receive buffers must be at least 64 bytes 
long to allow time for buffer lookahead. 

1 DTX - Disable the Transmitter 

0 = LANCE can access the Transmit Descriptor Ring 
1 = LANCE does not access the Transmit Descriptor Ring, 

therefore no transmissions are attempted. DTX = 1 clears 
the TXON bit in CSRO when initialization is complete. 

0 DRX - Disable the Receiver 

0 = Receives incoming packets 

1 = LANCE rejects incoming packets and does not access the 
Receive Descriptor Ring. DRX = 1 clears the RXON bit in 
CSRO when initialization is complete. 


The Mode field allows alteration of the LANCE operating parameters. In 
normal operation, the Mode Register clear. 
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Physical Address Field 
(Initialization Block, Offset 02H) 

PADR, the Network Physical Address, is the unique 48-bit physical address 
assigned to the LANCE. PADR(O) must be zero. 

Logical Address Filter Field 
(Initialization Block, Offset 08H) 

LADRF, the Logical Address Filter Field, is a 64-bit mask used by LANCE to 
accept the logical addresses. 

The Logical Address Filter is a 64-bit mask that accepts incoming Logical 
Addresses sent through the CRC circuit. After all 48 bits of the address have 
travelled through the CRC circuit, the high-order 6 bits of the resultant CRC 
are strobed into a register. This register selects one of the 64-bit positions in 
the Logical Address Filter. If the selected filter bit equals 1, the address is 
accepted and the packet is put in memory. The first bit of the incoming ad¬ 
dress must be 1 for a logical address. If the first bit is 0, it is a physical ad¬ 
dress and is compared against the physical address that was loaded through 
the Initialization Block. 

The Broadcast address, which is all ones, does not go through the Logical 
Address Filter and is always enabled. If the Logical Address Filter is loaded 
with all zeros, all incoming logical addresses except Broadcast are rejected. 
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Receive Descriptor Ring Pointer Field 
(Initialization Block, Offset 10H) 


31 

30 

29 

28 

27 

26 

25 

24 


1 1 


1 


1 

* 

k 


RLEN 

l l 


1 


RES 

l 

1 

1 

23 

22 

21 

20 

19 

18 

17 

16 


1 1 

1 1 


1 

1 

i 


1 I 


RDRA 

1 


1 

1 

1 

15 

14 

13 

12 

11 

10 

9 

8 


1 1 


* 


1 

i 

1 


1 1 


RDRA 

1 


1 

1 

1 

7 

6 

5 

4 

3 

2 

1 

0 


i i 


1 


i 

1 

1 




RDRA 


0 

0 

0 


_J_L 

_1 

1_1_ 


_J_ 

J_ 

1 
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Bit 


Description (Receive Descriptor Ring Pointer Field) 


31-29 


28-24 

23-0 


RLEN - RECEIVE RING LENGTH 

The number of entries in the Receive Ring expressed as a power 
of two. 

RLEN 

Number of Entries 
0 1 

1 2 

2 4 

3 8 

4 16 

5 32 

6 64 

7 128 

RES (Reserved) 

RDRA - Receive Descriptor Ring Address 

RDRA is the base address (lowest address) of the receive descrip¬ 
tor ring. Because the receive rings must be aligned on quadword 
boundaries, bits 2-0 must be zeros. 
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Transmit Descriptor Ring Pointer Field 
(Initialization Block, Offset 14H) 


31 

30 

29 

28 


27 


26 


25 


24 


1 

1 

1 



1 


1 


1 




TLEN 






RES 





1 

1 

1 



, 


1 


| 


23 

22 

21 

20 


19 


18 


17 


16 


1 

1 

1 



1 


1 


1 





TDRA 









1 

1 

1 



I 


1 


, 


15 

14 

13 

12 

_ 

11 


10 


9 


8 


1 

1 

1 



1 


1 


1 





TDRA 









1 

1 

1 



| 


1 


I 


7 

6 

5 

4 

_ 

3 


2 


1 


0 


1 

i 

1 



i 


1 


1 





TDRA 









_l_ 

_1_ 

_l_1 

_ 


_l_ 

0 

_1_ 

0 

_l_ 

0 
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Bit 


Description (Transmit Descriptor Ring Pointer Field} 


31-29 


28-24 

23-0 


TLEN 


TLEN is the number of entries in the Transmit Ring expressed 
as a power of two. 


TLEN 

0 

2 

3 

4 

5 

6 

7 

8 


Number of 
Entries 
1 
4 
8 

16 

32 

64 

128 

256 


RES - Reserved 

TDRA - Transmit Descriptor Ring Address 

TDRA is the base address (lowest address) of the Transmit 
Descriptor Ring. Because the transmit rings must be aligned on 
quadword boundaries, these bits 2-0 must be zeros. 
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Buffer Management 

Buffer descriptors, organized as ring structures in memory, are used for buffer 
management. The buffer descriptors, also called message descriptors, are four 
words long and point to a buffer. Two ring structures are allocated for the 
LANCE: a ring of receive message descriptors (RMDs) and a ring of transmit 
message descriptors (TMDs). To transmit or receive packets, the LANCE polls 
each ring structure. The LANCE also enters status information in the descrip¬ 
tor entry. The LANCE is limited to looking only one descriptor entry ahead of 
the one with which the LANCE is currently working. 

The location of the descriptor rings and their length are found in the initializa¬ 
tion block, which the LANCE accesses during the initialization procedure. 
Writing a 1 into the STRT bit of CSRO causes the LANCE to start accessing 
the descriptor rings and enables the sending and receiving of data packets. 

The LANCE communicates with the data link layer program through the ring 
structures in memory. Each entry in the ring is owned either by the LANCE 
or the data link layer program. The ownership bit (OWN) in the message 
descriptor entry determines who owns the entry. Therefore, ownership of a 
descriptor entry is mutual exclusive. To gain ownership of a descriptor entry, 
the communications partner (LANCE or data link layer program) must wait 
until the owner gives ownership to the communications partner. Between the 
time a communications partner relinquishes ownership of a descriptor entry and 
the time that communications partner regains ownership, it must not change 
any data in the descriptor entry. 
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Descriptor Rings in Memory 

Figure 13-1 shows receive and transmit descriptor rings with 128 message 
descriptors each. 


Higher 

Addresses 


Base Address 
of 

Transmit Ring 


Higher 

Addresses 


Base Address 
of 

Receive Ring 


Figure 13-1 Descriptor Rings 
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Receive Descriptor Rings 

Each descriptor in a ring in memory is a 4 word entry. The format of the 
receive descriptor follows. 

Receive Message Descriptor 0 (RMDO) 

15 14 13 12 11 10 9 8 


-1-1-1-1-1-1-1- 

LADR 

_1_1_1_1_1_1_ 1 _ 

7 

6 5 4 3 2 1 0 


i i i i i i i 

LADR 


1 1 1 1 1 I I 

Bit 

Description 

15-0 

LADR - Low Order Address 

The LADR of the buffer pointed to by this descriptor. LADR is 
written by the software and unchanged by the LANCE. This is the 
memory location to place the next received message. 
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Receive Message Descriptor 1 (RMD1) 


15 

14 

13 

12 

11 

10 

9 

8 

OWN 

ERR 

FRAN 

OFLO 

CRC 

BUFF 

STP 

ENP 

7 

6 

5 

4 

3 

2 

1 

0 

1 

1 1 

1 . 1 

1 





HADR 




1 

1_1 

1_ 1 

. 

_1_ 

_1_ 

Bit 

Description 







15 OWN 

0 = Descriptor entry owned by the data link layer software 
1 = Descriptor entry owned by the LANCE 


The LANCE clears the OWN bit after filling the buffer pointed to 
by the descriptor entry. The software sets the OWN bit after 
emptying the buffer. Once the LANCE or software has relin¬ 
quished ownership of a buffer, it may not change any field in the 
four words that comprise the descriptor entry. 

14 ERR - Error 

0 = The four bits, FRAM, OFLO, CRC or BUFF, are all equal to 
zero. 

1 = One or more of the four bits, FRAM, OFLO, CRC or BUFF, 
is equal to one. 

ERR is set by the LANCE and cleared by the software. 

13 FRAM - Framing Error 

0 = No framing error 

1 = The incoming packet contained a non integer multiple of 
eight bits and there was a CRC error. 

A CRC error on the incoming packet is a necessary condition for 
FRAM to equal 1 (even if there was a non integer multiple of eight 
bits in the packet). FRAM is set by the LANCE and cleared by 
the software. 
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Bit Description (RMD1 • cont.) 

12 OFLO - Overflow Error 

0 = No overflow error 

1 = The receiver has lost all or part of the incoming packet be¬ 
cause it cannot store the packet in a memory buffer before 
the internal SILO has overflowed. 

OFLO is set by the LANCE and cleared by the software. 

11 CRC - Cyclic Redundancy Check 

0 = No CRC error 

1 = The receiver detected a CRC error on the incoming packet. 

CRC is set by the LANCE and cleared by the software. 

10 BUFF - Buffer Error 

0 = No buffer error 

1 = The LANCE does not own the next buffer while data chain¬ 
ing a received packet. This condition could occur if the OWN 
bit of the next buffer was zero or the LANCE could not ac¬ 
quire the next status before silo overflow occurred. 

BUFF is set by the LANCE and cleared by the software. 

9 STP - Start of Packet 

0 = This is not the first buffer the LANCE uses for this packet. 

1 = This is the first buffer LANCE uses for this packet. It is 
used for data chaining buffers. 

STP is set by the LANCE and cleared by the software. 

8 ENP - End of Packet 

0 = This is last buffer LANCE uses for this packet. 

1 = This is the last buffer used by the LANCE for this packet. It 
is used for data chaining buffers. 

Both STP and ENP set indicate that the packet fit into one buffer 
and there was no data chaining. ENP is set by the LANCE and 
cleared by the software. 

7-0 HADR - High Order 8 Address Bits 

The HADR of the buffer pointed to by this descriptor. This field is 
written by the software and unchanged by the LANCE. 
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Receive Message Descriptor 2 (RMD2) 


15 

14 

13 

12 

11 10 9 

8 





l .. i 

BCNT 


1 

1 

1 

1 

_1_1_ 1 

1 


76543210 


- 1 - 1 - 

- 1 - 

- 1 - 

BCNT 

— 1 - 

1 

- 1 - 

_ 1 _ 1 _ 

1 

_ 1 _ 

_ 1 _ 

, 

_ 1 _ 


Bit Description 

15-12 Must be ones. This field is written by the software and unchanged 

by the LANCE. 

11-0 BCNT - Buffer Byte Count 

BCNT is the length of the buffer pointed to by this descriptor ex¬ 
pressed as a two’s complement number. This field is written by the 
software and unchanged by the LANCE. The minimum buffer size 
is 64 bytes. 
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Receive Message Descriptor 3 (RMD3) 


15 

14 

13 

12 


11 

10 


9 

8 

1 


RES 




i 

i 

MCNT 



1 


1 

J 



1 

1 


. 

7 

6 

5 

4 


3 

2 


1 

0 

I 


1 

i 

MCNT 




1 

1 

_L_ 


_1_ 

_1_ 


_l_ 

_1_ 

_1 

1_ 


Bit Description 

15-12 RES 

Reserved and read as zeros. 

11-0 MCNT - Message Byte Count 

MCNT is the length in bytes of the received message. MCNT is 
valid only when ERR is clear and ENP is set. MCNT is written by 
the LANCE and cleared by the software. When data chaining, 
RMD3 is only loaded by the LANCE when the status of last buffer 
is updated. Only the status word is updated for the other buffers 
in the data chain. 
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Transmit Descriptor Ring 

Each descriptor in a ring in memory is a 4 word entry. The format of the 
transmit descriptor follows. 

Transmit Message Descriptor 0 (TMDO) 


15 

14 

13 

12 11 

10 

9 

8 



1 

i i 

LADR 

1 


* 



1 

1 1 

1 . 


I 

7 

6 

5 

4 3 

2 

1 

0 

i 

1 


■ i 

LADR 

• i 

i 

i 

_1 


_l_ 

_l_1_ 

_J_1 

1 _ 

1 


Bit Description 


15-0 LADR - Low Order 16 Address Bits 

The LADR of the buffer pointed to by this descriptor. LADR is 
written by the software and unchanged by the LANCE. 
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Transmit Message Descriptor 1 (TMD1) 


15 

14 

13 

12 


11 

10 

9 

8 

OWN 

ERR 

RES 

MORE 

ONE 

DEF 

STP 

ENP 

7 

6 

5 

4 


3 

2 

1 

0 

1 

1 1 

1 1 


i i 

HADR 

1 1 

1 1 

1 

I 

1_1 

_ 1 _ 

_ 1 _ 

1 1 

1 1 

1 

Bit 

Description 








15 OWN 

0 = Owned by the LANCE 
1 = Owned by the data link layer software 


OWN indicates whether the descriptor entry is owned by the soft¬ 
ware (OWN = 0) or by the LANCE (OWN = 1). The software sets 
the OWN bit after filling the buffer pointed to by this descriptor. 
The LANCE clears the OWN bit after transmitting the contents of 
the buffer. Neither the software nor the LANCE may alter a 
descriptor entry after relinquishing ownership. 

14 ERR - Error Summary 

0 = All of LCOL, LCAR, UFLO. and RTRY equal 0. 

1 = One or more of LCOL, LCAR, UFLO, or RTRY equal 1. 

ERR is set by the LANCE and cleared by the software. 

13 RES- Reserved (Always 0) 

12 MORE 

0 = One retry or less was needed to transmit a packet. 

1 = More than one retry was needed to transmit a packet. 

MORE is set by the LANCE and cleared by the software. 
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Bit 


Description (TMD1 - cont.) 


11 ONE 

0 = The number of retries need to transmit a packet is not equal 

1 . 

1 = Exactly one retry was needed to transmit a packet. 

ONE is set by the LANCE and cleared by the software. 

10 DEF - Deferred 

0 = The channel is ready for LANCE to transmit a packet. 

1 = The channel is busy when the LANCE is ready to transmit a 
packet. 

DEF set by the LANCE and cleared by the software. 

9 STP - Start of Packet 

0 = Not the first buffer LANCE uses for this packet. 

1 = The first buffer to be used by the LANCE for this packet. It 
is used for data chaining buffers. 

STP is set by the software and unchanged by the LANCE. 

8 ENP - End of Packet 

0 = Not the last buffer LANCE uses for this packet 
1 = The last buffer to be used by the LANCE for this packet. It 
is used for data chaining buffers. 

If both STP and ENP are set, the packet fit into one buffer and 
there was no data chaining. ENP is set by the software and un¬ 
changed by the LANCE. 

7-0 HADR - High-Order 8 Address Bits 

HADR is the high-order 8 address bits of the buffer pointed to by 
this descriptor. HADR is written by the software and unchanged 
by the LANCE. 
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Transmit Message Descriptor 2 (TMD2) 
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15-12 Always 1. This field is set by the software and unchanged by the 

LANCE. 

11-0 BCNT - Buffer Byte Count 


BCNT is the number of bytes LANCE transmits of the buffer to 
which TMD2 points. BCNT is expressed in 2’s complement. 

BCNT is written by the software and not affected by the LANCE. 
The minimum size of the buffer is 64 bytes. 
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Message Descriptor 3 (TMD3) 
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15 BUFF - Buffer Error 

0 = No buffer error 

1 = LANCE, during transmission, does not find the ENP flag in 
the current buffer and does not own the next buffer. BUFF 
= 1 also if the LANCE owns the next buffer but can not 
read the next buffer’s status parameters before the silo un¬ 
derflowed. 

BUFF is set by the LANCE and cleared by the software. If a 
Buffer Error occurs, an Underflow Error also occurs because the 
transmitter continues to read data from the silo until empty. 

14 UFLO - Underflow Error 

0 = No underflow error 

1 = The transmitter has truncated a message due to lack of data 
from memory. UFLO indicates that the Silo has emptied 
before the end of the packet was reached. 

UFLO is set by the LANCE and cleared by the software. 

13 RES - Reserved (Always 0) 

12 LCOL - Late Collision 

0 = No collision 

1 = A collision occurred after the slot time of the channel has 
elapsed. 

The LANCE does not retry on late collisions. LCOL is set by the 
LANCE and cleared by the software. 
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Bit 


Description (TMD3 - cont.) 


11 


10 


9-0 


TMD3 


LCAR - Loss of Carrier 

0 = RENA does not go false during transmission 
1 = The carrier presence (RENA) input to the LANCE goes false 
during a transmission initiated by the LANCE. The LANCE 
does not retry upon Loss of Carrier. 

LCAR is set by the LANCE and cleared by the software. 

RTRY - Retry Error 
0 = No retry error 

1 = The transmitter has failed in 16 attempts to transmit a 

message due to repeated collisions on the medium. If DRTY 
= 1 in the MODE register, RTRY sets after 1 failed 
transmission attempt. 

RTRY is set by the LANCE and cleared by the software. 

TDR - Time Domain Reflectometry 

The TDR shows the state of an internal LANCE counter that 
counts from the start of a transmission to the occurrence of a colli¬ 
sion. This value is useful in determining the approximate distance 
to a cable fault. The TDR value is written by the LANCE and is 
valid only if RTRY is set. 


is valid only if the LANCE has already set the ERR bit of TMD1. 
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Network Interface External Interconnect 

The VAXmate network hardware connects to the network coaxial cable through 
a BNC T-connector. The VAXmate network hardware complies with IEEE 
802.3 10BASE2 specifications. The cable shield is isolated from the VAXmate 
logic and chassis ground, and must be externally grounded by the interconnect 
equipment. The VAXmate workstation does not contain a 50-ohm line- 
termination. The 50-ohm line terminator must be supplied externally, as re¬ 
quired by the connection topology. 

Network Interface System Bus Interconnect 

The hardware interface uses the 16-bit and 8-bit system bus for data transfers. 
It operates in both bus master and bus slave modes. In bus slave mode, the 
registers respond to I/O cycles. The LANCE registers require 16-bit I/O and 
the NI CSR register requires an 8-bit I/O. All of the network interface registers 
are located in proprietary I/O address space of the VAXmate workstation. 
Accessing the LANCE registers can cause extra I/O wait states. 

In the bus master mode, the LANCE initiates 16-bit memory cycles to transfer 
data, commands and parameters to and from main system memory. The 
VAXmate workstation supports both 16-bit and 8-bit memory cycles, but the 
network interface supports only 16-bit memory cycles. Although the VAXmate 
uses the READY signal to support asynchronous memory cycles, the network 
interface supports only synchronous memory cycles. The network interface per¬ 
forms DMA transfers at the rate of 600 ns per cycle. 

The network hardware works with standard system memory resident on the 
VAXmate CPU module, and with the VAXmate memory option located in the 
workstation main box. Accesses to 8-bit memory in the VAXmate expansion 
box are not supported by the network hardware. If the memory complies with 
the network hardware timing requirements, third-party 16-bit memory in the 
expansion box may work correctly. 

The interface does not support DMA to the VAXmate video display memory. 
The interface uses the full 24-bit physical memory address space and operates 
with physical addresses only. 

The network hardware uses interrupt line IRQ10, and a special LAN DMA 
request line, provided by the CPU Module. The special LAN DMA request line 
has higher priority than all DRQs lines on the system bus. 
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input/output ports 3-3 
operation command words 3-11 
registers 3-3 
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LK250 keyboard responses 8-31 

Active cycle 

DMA controller 4-3 

Add name for session 18-101 

Add node for session 18-120 
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DMA controller 4-5 
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Alias I/O port addresses 13-5 
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ANSI functions 
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ANSI support 

inside a window 17-79 

ANSI.SYS 16-5 

Cursor control functions 16-5 
Erase functions 16-7 
installing 16-5 

Keyboard key reassignment func¬ 
tion 16-12 

Reset mode function 16-11 
Set graphics rendition function 
16-8 

Set mode function 16-10 
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communications 9-1 
interrupt 15-70 
memory cycles 13-40 
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requests 18-89 

serial communications interface 
17-62 

serial mouse interface 10-2 
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Attribute code 7-6 

Auto-initialize 

DMA controller 4-4 

Automatic LED control 15-108 
Available (IRQ15) interrupt 15-151 

B 

BACKSPACE 

to abort compose sequence 17-5 

Base and current 
address register 4-7 
word register 4-8 

Basic interrupt 15-132 

Baud rate 9-16 
mouse 10-2 

Beep function 6-18 

Begin virtual mode function 15-96 

Bell sound 6-18 

Bits 

DMA controller 
write all 4-11 
write single mask 4-11 

Block transfer mode 
DMA controller 4-3 

Boot block, DIGITAL hard disk 

15-134 

Bootstrap interrupt 15-133 
Buffer overrun 

LK250 keyboard responses 8-30 
Bus 13-3 

16-bit expansion 2-9 
16-bit local 2-9 
8-bit expansion 2-9 
arbitration 13-3 
master mode 13-40 
slave mode 13-40 
timing and structure 2-9 


Button position 10-3 
C 

C programming language 
subroutines A-l 

Call function for session 18-105 
Call-back 
for datalink 

line state change 18-9 
user 18-8 
for LAT 18-58 

Cancel 

alarm function 15-140 
function for session 18-97 

Cascade mode 

DMA controller 4-4 

Case conversion tables 16-29 
Cassette input/output interrupt 15-88 
Change register 11-6 

Character 
code 7-6 
count 17-77 
count function 15-114 
pattern 7-9 
position mapping 7-7 
set provided in the custom font 

17-74 

Check for presence of session 18-96 
ClearCommBreak 17-65 
Clock tick interrupt 15-5 
Close 

datalink portal 18-20 
device function 15-89 
LAT session 18-67 

CloseComm 17-64 
CloseLat 17-68 

CMOS configuration 
updated 14-10 
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CMOS RAM 

shutdown byte read during hard 
reset 14-13 

Coax transceiver interface 13-2 

Color 

map functions 15-32 
select register 7-39 

COMl/serial interrupt 15-6 

COM2/modem interrupt 15-6 

Combination keys 15-107 
break 15-108 
extended self-test 15-108 
pause 15-108 
print screen 15-108 
system request key 15-107 
system reset 15-107 

Commands 

counter-latch, three-channel 
counter and speaker 6-12 
disable keyboard, keyboard- 
interface controller 8-12 
diskette drive controller 11-19 
enable keyboard, keyboard- 
interface controller 8-12 
incremental stream mode (mouse) 
10-3 

interface test, keyboard-interface 
controller 8-12 
invoke self-test (mouse) 10-3 
keyboard-interface controller 8-9 
mouse (table) 10-2 
prompt mode (mouse) 10-3 
pulse output port, keyboard- 
interface controller 8-12 
read port 1, keyboard-interface 
controller 8-12 

read port 2, keyboard-interface 
controller 8-13 
read test inputs, keyboard- 
interface controller 8-13 
read-back, three-channel counter 
and speaker 6-13 


read, keyboard-interface controller 
8-10 

self-test 8-12 

vendor reserved function (mouse) 
10-3 

write port 2 8-13 
write status register 8-13 
write, keyboard-interface controller 
8-10 

Command and result register sets 
diskette drive controller 11-20 

Command codes 

disable autorepeat 8-24 
disable key scanning and restore 
to defaults 8-28 
echo 8-26 

enable autorepeat 8-24 
enable key scanning 8-28 
enter DIGITAL extended scan 
code mode 8-23 

exit DIGITAL extended scan code 
mode 8-23 

invalid commands 8-23 
keyboard mode lock 8-25 
keyboard mode unlock 8-25 
LEDs on/off 8-26 
LK250 keyboard 8-22 
request keyboard id 8-23 
resend 8-29 

reserved 8-25, 8-26, 8-29 
reset 8-29 

reset keyboard led 8-24 
restore to defaults 8-28 
set autorepeat delay and rate 8-27 
set keyboard led 8-23 
set keyclick volume 8-24 

Command register 4-9, 10-12, 12-10 
keyboard-interface controller 8-5, 
8-9 

Command state 

diskette drive controller 11-18 

Communications 17-61 
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connector signals 9-19 
extended self-test loopback test 
14-10 

full asynchronous parallel 17-61 
full asynchronous serial 17-61 
LAT support 17-62 

Communications functions 
ClearCommBreak 17-65 
CloseComm 17-64 
EscapeCommFunction 17-65 
FlushComm 17-65 
GetCommError 17-66 
GetCommEventMask 17-65 
GetCommState 17-65 
OpenComm 17-63 
ReadComm 17-64 
SetCommBreak 17-65 
SetCommEventMask 17-65 
SetCommState 17-65 
TransmitCommChar 17-64 
WriteComm 17-63 

Compose sequences 16-23, 17-4 
aborting 17-5 
default set 17-5 
handling 17-4 
how recognized 16-23 
pointer table 
format 16-24 
use 16-24 
translation table 
format 16-24 
use 16-24 
two key 17-5 

Configuration list 14-11 
display 14-11 

Console server identify self 18-42 

Constant values 
DMA controller 
programming example 4-15 

Control Panel 17-6 

Control register 11-3 
register A 7-41 


register B 7-43 
registers 7-3, 7-41, 7-43 

Control signals 

speed indicator 9-17 
speed select 9-17 

Control word register 6-11 

Controller 
functions 13-2 
keyboard-interface 8-1 

Counter and speaker example 6-20 

Counter signals 6-3 

Counter-latch command 

three-channel counter and speaker 
6-12 

CPU 13-3 

Creating keyboard map tables 16-22 

CRT Controller 7-3 

CRTC registers 
data 7-25 
index 7-25 
register R0 7-28 
register R1 7-28 
register RIO 7-33 
register Rll 7-34 
register R12 7-34 
register R13 7-34 
register R14 7-35 
register R15 7-35 
register R16 7-36 
register R17 7-36 
register R2 7-29 
register R3 7-29 
register R4 7-30 
register R5 7-30 
register R6 7-31 
register R7 7-31 
register R8 7-3 
register R9 7-33 

Crystal oscillator 13-4 

CTI - see coax transceiver interface 
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Ctrl and Alt keys 

Del keys used for soft reset 14-12 
with Home key for diagnostics 

14- 10 

Cursor control functions 16-5 

Custom LAT application interface 

17- 66 

Cylinder number 
high register 12-8 
low register 12-8 

D 

.DEF files 17-10, 17-72 
ID for LAT 18-55 
Data 

controller 13-3 
link interface 13-1 
structures accessed by LANCE 
13-3 

transfer 13-40 

Data exchange for LAT 18-58 

Data registers 7-39, 11-5, 12-3 
accessing 7-26 

keyboard-interface controller 8-5 

Data structures 
DMA controller 
programming example 4-17 

Data transfers 

DMA controller 4-4 
rate register 11-6 

Datagrams 18-113 
defined 18-83 

Datalink communication block (DCB) 

18- 7 

functions 18-11 

close a portal 18-20 
deallocate buffer 18-26 


disable a channel 18-38 
disable multicast address 18-22 
enable a channel 18-37 
enable multicast address 18-21 
external loopback 18-41 
initialization 18-15 
MOP start and send system ID 
18-45 

MOP stop 18-45 

network boot request 18-36 

open a portal 18-17 

read channel status 18-27 

read counters 18-32 

read DECparm address 18-39 

read portal list 18-29 

request transmit buffer 18-25 

set DECparm string address 

18-40 

transmit 18-23 
overview 18-5 
parameters 18-16 
port driver 18-5 
program example 18-46 
read portal status 18-30 
receive 18-10 
return codes 18-12 
transmit 18-10 
user call-back routines 18-8 

Date and time structure 16-3, 16-4 

Dead diacritical keys 16-24, 17-4 
how recognized 16-24 

Deallocate buffer for datlink 18-26 

DEC private RAM 

powerup test checks 14-8 

decfuncadd 18-120 
decfunccheck 18-119 
decfuncdelall 18-126 
decfuncdelname 18-122 
decfuncdelnum 18-121 
decfuncreadindex 18-125 
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decfuncreadname 18-124 
decfuncreadnum 18-123 
DecGetKbdCountry 17-8 

DECnet DOS session level interface 

13- 1 

DECparm address string 18-40 
DecSetAutorep 17-7 
DecSetComposeState 17-5, 17-9 
DecSetKClickVol 17-7 
DecSetLockState 17-6 
DecSetNumlockMode 17-10 
DECWIN.H 17-85 
Delete 

entry given node name for session 
18-122 

entry given node number for 
session 18-121 
name for session 18-102 
node entries for session 18-126 

Demand transfer mode 
DMA controller 4-3 

Device is busy function 15-98 
Diagnose command 12-21 

Diagnostic initialization procedure 

14- 12 

hardware initialized 14-12 
memory sized 14-12 

Diagnostic loopback 9-10 
Diagnostics 

extended self-test 14-10 
hard reset 14-13 

keyboard-interface controller 8-4, 
8-12 

powerup test 14-1, 14-8 
processor board tests 14-14 
ROM 14-1, 14-8 
ROM extended self-test 14-10 
soft reset 14-12 


DIGITAL 

function check for session 18-119 
hard disk boot block 15-134 
input register 12-26 
session control block (DSCB) 
18-85, 18-88 

session functions 18-118 

DIGITAL extended functions 
extended codes and functions 

15-116 

set modem control 15-85 

DIGITAL extension functions 
character count 15-114 
extended mode 15-77 
key notification 15-111 
keyboard buffer 15-115 
keyboard table pointers 15-120 
parallel port retry 15-131 
printer type 15-129 
redirect parallel printer 15-127 
request keyboard id 15-118 
retry on timeout error 15-86 
return days-since-read counter 
15-140 

return DIGITAL configuration 
word 15-99 
send break 15-84 
send to keyboard 15-119 
set baud rate 15-87 

DIGITAL extension interrupts 
basic 15-132 
bootstrap 15-133 
local area network controller 
(LANCE) 15-149 
mouse port 15-150 

Direct memory access and LANCE 
13-3 

Disable 

autorepeat keyboard-interface con¬ 
troller command codes 8-24 
channel for datalink 18-38 
key scanning and restore to 
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defaults 8-28 
keyboard command 8-12 
multicast address for datalink 
18-22 

Disk input/output (I/O) interrupt 
15-38 

hard disk errors 15-40 

hard disk functions 15-40 

hard disk parameter tables 15-41 

Disk parameters 16-14 

Diskette 
errors 15-59 
functions 15-59 
parameter tables 15-59 
interrupt 15-143 

Diskette drive controller 
change register 11-6 
command and result register state 
11-20 

command register 11-7 
command state 11-18 
commands 11-19 
control register 11-3 
D 11-17 

data register 11-5 
data transfer rate registers 11-6 
DMA mode 11-1 
DTL 11-16 
EOT 11-16 
execution state 11-20 
extended self-test loopback test 
14-10 

GPL 11-16 
H 11-15 

head/unit select register 11-8 
hlt/nd 11-15 
internal registers 11-7 
main status register 11-4 
N 11-16 
NCN 11-17 

operational states 11-18 
PCN 11-17 
programming 11-18 


programming example 11-27 
R 11-15 
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format track 11-24 
read data 11-21 
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read id 11-23 
read track 11-23 
recalibrate 11-26 
scan equal 11-24 
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seek 11-27 

sense drive status 11-27 
sense interrupt status 11-26 
specify 11-26 
write data 11-21 
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registers 11-2 
result state 11-20 
result state 

invalid commands 11-20 
SC 11-16 
srt/hut 11-14 
status register 0 11-9 
status register 1 11-10 
status register 2 11-12 
status register 3 11-13 
STP 11-17 

Diskettes 

extended self-test use of 14-10 
DispatchMessage 17-4 
Display 

on VAXmate 17-73 
processor 7-3 

Divisor latches 9-15 
DLL.EXE 18-5 
dll_close 18-20 
dll_deallocate 18-26 
dll_disable_chan 18-38 
dll_disable_mul 18-22 
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dll_enable_chan 18-37 
dll_enable_mul 18-21 
dll_ext_loopback 18-41 
dll_init 18-15 
dll_network_boot 18-36 
dll_open 18-17 
dll_readecparm 18-39 
dll_read_chan 18-27 
dll_read_counters 18-32 
dll_read_plist 18-29 
dll_read_portal 18-30 
dll_request_xmit 18-25 
dll_setdecparm 18-40 
dll_transmit 18-23 
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disabling 4-22 

DMA controller 
active cycle 4-3 
address generation 4-5 
auto-initialize 4-4 
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4-7 

base and current word register 4-8 
block transfer mode 4-3 
cascade mode 4-4 
command register 4-9 
data transfer 4-4 
demand transfer mode 4-3 
idle cycle 4-3 
mode 4-12 

modes and restrictions 4-1 
operation 4-2 
priorities 4-5 

programming example 4-15 
data structures 4-17 
disabling DMA channel 4-22 
initializing 4-18 
opening DMA channel 4-19 


preparing DMA channel 4-20 
registers 4-7 
request register 4-13 
single transfer mode 4-3 
states 4-2 

status register 4-11 
temporary register 4-14 
write all mask bits 4-11 
write single mask bit 4-11 

DMA mode 11-1 
DRQ 13-40 

E 

Echo 

keyboard-interface controller com¬ 
mand codes 8-26 
LK250 keyboard responses 8-30 

Edit keypad 17-3 
Enable 

autorepeat 8-24 
channel for datalink 18-37 
key scanning 8-28 
keyboard command 8-12 
multicast address for datalink 
18-21 

Enable/disable 

256 character graphic font func¬ 
tion 15-30 

additional key codes 17-77 

End-of-interrupt command 
issuing 3-26 

Enter 

DEC Mode 17-76 
DIGITAL extended scan code 
mode 8-23 

Erase functions 16-7 
Error handling 

keyboard-interface controller 8-14 
LK250 keyboard 8-31 
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Error register 12-5 

EscapeCommFunction 17-65 

Ethernet 

CRC bits 13-3 
preamble 13-3 
sync pattern 13-3 
transmission 13-8 

Execute controller internal diag¬ 
nostics function 15-56 

Execution state 

diskette drive controller 11-20 

Exit 

DEC Mode 17-76 
DIGITAL extended scan code 
mode 8-23 

Expansion box 

bus connectors 2-11 
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slot power ratings 2-10 
technical specifications 2-10 

Extended 

codes and functions 15-116 
mode function 15-77 
scan code mode 17-2 

Extended keyboard functions 

enable/disable additional key codes 
17-77 

enter DEC mode 17-76 
exit DEC mode 17-76 

Extended keyboard functions (not 
supported) 

character count 17-77 
get/set table pointer 17-78 
key notification 17-77 
keyboard buffer 17-77 
request keyboard id 17-78 

Extended self-test 
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diskette drive controller 14-10 
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firmware diagnostics 14-10 
hardware initialization 14-10 
horizontal bar 14-10 
loopback test 
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on mouse serial ports 14-10 
on printer 14-10 
memory sized 14-10 
real-time clock 14-10 
video failures 14-10 

External loopback 18-41 

F 

Fetch next character from keyboard 
17-75 

File structure 

LCOUNTRY 16-27 

Firmware diagnostics 
error codes 14-8 
error values 14-8 
extended self-tests 14-10 
horizontal bar 14-8, 14-10 
initialization procedure 14-8 
ROM BIOS and 14-8 
self-tests 14-8 

Fixed disk register 12-25 

Fixed priority 

DMA controller 4-5 

Floppy disk interrupt 15-7 

Flow control for LAT 18-58 

FlushComm 17-65 

Focus 

changing for repeating key 17-11 

FONT 16-15 

Font file structure 
FONT.COM 16-17 
GRAFTABL.COM 16-18 

Font files 
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loading 16-19 

Font RAM 
accessing 7-9 

color map support function 15-31 
functions 15-31 
programming 7-9 

Font sizes 

terminal emulation 17-73 
FONT.COM 

affect on KEYB.COM 16-16 
affect on SORT.EXE 16-16 
font file structure 16-17 

Fonts 

description 16-16 

Format track 15-66 
command 12-17 
function 15-47 
diskette drive controller 
register sets 11-24 

Functional description of network 
hardware interface 13-2 

Functions 

datalink 18-11 
interrupt vector A-12 
LAT 18-64 
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buffer A-16 
session 18-91 

DIGITAL-specific 18-118 
storing characters in a ring buffer 
A-16 

support for example programs 
A-18 

GDI 17-2 

printer support 17-83 
Get 

Country Code Function 16-3 
current date and time for SMB 
18-128 

MS-DOS OEM Number Function 
16-3 


next LAT service name 18-70 
status for LAT 18-65 

Get/Set Table Pointer 17-78 
GetCommError 17-66 
GetCommEventMask 17-65 
GetCommState 17-65 
GetLatService 17-71 
GetLatStatus 17-69 
GetMessage 17-4 
GRAFTABL 16-16 

GRAFTABL.COM 

font file structure 16-18 

Graphics 

character table pointer interrupt 
15-145 

device interface 17-2 
format memory maps 7-10 
mode 7-10 

H 

Hangup for session 18-108 
Hard disk 

boot block, DIGITAL 15-134 
interrupt 15-151 

parameter tables interrupt 15-146 
reset function 15-53 
types 16-13 

Hard disk controller 

alternate status register 12-25 
command register 12-10 
cylinder number high register 12-8 
cylinder number low register 12-8 
data register 12-3 
diagnose command 12-21 
DIGITAL input register 12-26 
error register 12-5 
features 12-1 
fixed disk register 12-25 
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format track command 12-17 
programming example 12-27 
read sector command 12-13 
read verify command 12-19 
registers 12-1 
restore command 12-11 
SDH register 12-9 
sector count register 12-7 
sector interleave 12-18 
sector number register 12-7 
seek command 12-12 
set parameters command 12-22 
status register 12-23 
write precompensation register 
12-4 

write sector command 12-15 

Hard reset 14-13 
causes 14-13 
shutdown byte 14-13 

Hardware 

extended self-test 14-10 
initializing 14-8 
retriggable one-shot 6-4 
starting with Ctrl/Alt/Del 14-12 
system tests at startup 14-1 
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Hardware interrupts 
80287 error 15-151 
available (IRQ15) 15-151 
clock tick 15-5 
COM 1/serial 15-6 
COM2/modem 15-6 
floppy disk 15-7 
hard disk 15-151 
keyboard 15-5 

local area network controller 
(LANCE) interrupt 15-149 
mouse port 15-150 
nonmaskable interrupt 15-3, 15-76 
real-time clock 15-148 
redirect to interrupt OAH 15-148 
serial printer port 15-150 


I/O cycle, wait states introduced by 
LANCE 13-40 

ICONEDIT.EXE 17-83 
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unique 17-83 
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DMA controller 4-3 

IEEE 802.3 specification 13-2, 13-4 
10BASE2 specifications 13-40 

Illogical keyboard messages 17-12 
In-service register 3-16 

Include files 

LK250 keyboard A-10 

ring buffer control structure A-11 

structure declaration A-9 

Incremental stream mode command 
10-3 
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accessing 7-26 

Industry-standard functions 
begin virtual mode 15-96 
cancel alarm 15-140 
close device 15-89 
device is busy 15-98 
diskette 

errors 15-59 
functions 15-59 
parameter tables 15-59 
enable/disable 256 character 
graphic font 15-30 
execute controller internal diag¬ 
nostics 15-56 

font RAM and color map support 
15-31 

format a track 15-47, 15-66 
hard disk reset 15-53 
initialize 
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asynchronous port 15-72 
diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
printer 15-125 

interrupt completion handler 15-98 

keyboard input 15-109 

keyboard state 15-110 

keyboard status 15-109 

move a block of memory 15-93 

open device 15-89 

read 

character and attribute at 
cursor position 15-19 
current video state 15-27 
cursor position 15-14 
long 15-50 

long 256 byte sector 15-58 
one or more disk sectors 15-44 
one or more track sectors 15-63 
pixel 15-24 

real-time clock 15-137 
system clock 15-136 
recalibrate drive 15-55 
receive character 15-74 
return 

asynchronous port status 15-75 
change line status 15-68 
current drive parameters 15-48 
drive type 15-57, 15-67 
printer status 15-126 
RTC date 15-138 
size above one megabyte 15-95 
status code of last I/O request 
15-43, 15-62 

seek to specific cylinder 15-52 
service system request key 15-91 
set 

a wait interval 15-90 
alarm 15-139 
color palette 15-22 
cursor position 15-13 
cursor type 15-12 
page 15-16 


real-time clock 15-138 
RTC date 15-139 
system clock 15-136 
termination 15-90 
test drive ready 15-54 
transmit character 15-73,15-124 
TTY write string 15-28 
verify one or more disk sectors 
15-46 

verify one or more track sectors 
15-65 

wait (no return to user) 15-92 
write 

character and attribute at 
cursor position 15-20 
character at cursor position 
15-21 

character using terminal emula¬ 
tion 15-25 
long 15-51 

one or more disk sectors 15-45 
one or more track sectors 15-64 
pixel 15-23 

Industry-standard functions with 
DIGITAL extensions 
set drive and media type for 
format 15-69 
set video mode 15-10 

Industry-standard interrupts 
80287 error 15-151 
available (IRQ15) 15-151 
diskette parameter tables 15-143 
floppy disk 15-7 
hard disk 15-151 

hard disk parameter tables 15-146 
keyboard break 15-141 
nonmaskable interrupt 15-3, 15-76 
print screen 15-4 
read configuration 15-35 
read light-pen position 15-15 
real-time clock 15-148 
redirect to interrupt 0AH 15-148 
return memory size 15-37 
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revector of interrupt 13H 15-145 
RTC alarm 15-148 
serial printer port 15-150 
timer tick 15-141 
video parameters 15-142 

Industry-standard interrupts with 
DIGITAL extensions 
asynchronous communications 
15-70 

cassette input/output 15-88 
clock tick 15-5 
COM 1/serial 15-6 
COM2/modem 15-6 
disk input/output (I/O) 15-38 
graphics character table pointer 
15-145 

keyboard 15-5 
keyboard input 15-101 
printer output 15-123 
video input/output 15-8 
time-of-day 15-135 

Initialization for datalink 18-15 
Initialize 

asynchronous port 15-72 
diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
printer 15-125 

Input/output registers 
video processor 7-22 

InquireLatServices 17-70 

Installing 
ANSI.SYS 16-5 

options, extended self-test 14-10 
INT 11H support 17-82 
INT 12H support 17-82 
INT 15H support 17-83 
Interface 

signals, monitor 7-44 
test command, keyboard-interface 
controller 8-12 


Internal registers 

diskette drive controller 
C 11-15 
command 11-7 
D 11-17 
DTL 11-16 
EOT 11-16 
GPL 11-16 
H 11-15 

head/unit select 11-8 
hlt/nd 11-15 
N 11-16 
NCN 11-17 
PCN 11-17 
R 11-15 
SC 11-16 
srt/hut 11-14 
status register 0 11-9 
status register 1 11-10 
status register 2 11-12 
status register 3 11-13 
STP 11-17 

International support 
FONT 16-15 
GRAFTABL 16-16 

Interrupt 

completion handler function 15-98 
enable register 9-4 
identification register 9-6 
line status 9-10 
modem status 9-10 
on terminal count 

three-channel counter and 
speaker mode 6-4 

Interrupt 

2A 18-83, 18-91 
6A 18-64 
6D 18-11 

Interrupt 21H 
function 30H 16-3 
function 38H 16-3 

Interrupt 
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address map 2-6 
controller register, accessing 3-4 
controllers, programming example 
3-21 

line, IRQ10 13-40 
processing 3-18 
request lines 3-2 
request register 3-16 

Invalid commands 

keyboard-interface controller com¬ 
mand codes 8-23 

Invoke self-test command 10-3 


Joystick support function 15-91 
Jumpers 

processor board testing 14-14 
K 

Kernel 17-2 

Key buffering notification enabled 
15-113 

Key combinations 15-107 
break 15-108 
extended self-test 15-108 
pause 15-108 
print screen 15-108 
system request key 15-107 
system reset 15-107 

Key mappings 
LK250 17-13 

Key notification 17-77 
enabled 15-112 
function 15-111 

KEYB.COM. 16-19 

how affected by FONT.COM 16-16 

Keyboard 

break interrupt 15-141 


buffer interface 8-1 
buffer function 15-115 
driver 17-2 

illogical messages 17-12 
input function 15-109 
input interrupt 15-101 
interface lines 8-12 
interrupt 15-5 

key reassignment function 16-12 
layout, LK250 15-103 
LEDs 17-4 
LK250 17-2, 8-1 
map file structure 16-25 
map tables 
creating 16-22 

MS-Windows extensions 17-5 
processing anomalies 17-11 
scan codes 15-104 
setting user preferences 17-6 
state function 15-110 
status function 15-109 
table pointers function 15-120 
translation 15-121 

Keyboard extensions 

DecGetKbdCountry 17-8 
DecSetAutorep 17-7 
DecSetClickVol 17-7 
DecSetComposeState 17-9 
DecSetLockState 17-6 
DecSetNumlockMode 17-10 
enable/disable autorepeat 17-6 
return keyboard nationality 17-6 
select compose processing 17-6 
select Numlock processing 17-6 
set keyclick volume 17-6 
set Shift key 17-6 

Keyboard handling 
inside a window 17-75 
outside a window 17-78 

Keyboard mode 
lock 8-25 
toggling 17-4 
unlock 8-25 

Keyboard remapping 16-19 
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Keyboard-interface controller 8-1 
command byte bit definitions 8-10 
command codes 

disable autorepeat 8-24 
disable key scanning and restore 
to defaults 8-28 
echo 8-26 

enable autorepeat 8-24 
enable key scanning 8-28 
enter DIGITAL extended scan 
code mode 8-23 
exit DIGITAL extended scan 
code mode 8-23 
invalid commands 8-23 
keyboard mode lock 8-25 
keyboard mode unlock 8-25 
LEDs on/off 8-26 
request keyboard id 8-23 
resend 8-29 

reserved 8-25, 8-26, 8-29 
reset 8-29 

reset keyboard led 8-24 
restore to defaults 8-26 
set autorepeat delay and rate 
8-27 

set keyboard led 8-23 
set keyclick volume 8-24 
command register 8-5, 8-9 
commands 8-9 
data registers 8-5 
diagnostics 8-4 
disable keyboard 8-12 
enable keyboard 8-12 
error handling 8-14 
interface test 8-12 
keyboard responses 
acknowledge 8-31 
buffer overrun 8-30 
echo 8-30 
release prefix 8-31 
resend 8-31 
self-test failure 8-31 
self-test success 8-30 
physical interface 


to the CPU 8-1 
to the keyboard 8-1 
port bit definitions 8-3 
pulse output port 8-13 
read port 1 8-12 
read port 2 8-13 
read test inputs 8-13 
self-test 8-12 
status register 8-6 
write port 2 8-13 
write status register 8-13 

Keypad 
edit 17-3 
numeric 17-3 

Keys 

Numlock 17-3 

reserved under MS-Windows 17-5 


LANCE 

broadcast address 13-22 
buffer descriptors, see LANCE 
message descriptors 13-27 
buffer management 13-17 
control and status registers 13-3 
control register 13-3 
CRC 13-22 

CSRO 13-5, 13-6, 13-7, 13-8, 13-18 
CSR0-CSR3 13-5 

CSR1 13-4, 13-5, 13-6, 13-7, 13-13 
CSR2 13-4, 13-5, 13-6, 13-7, 13-14 
CSR3 13-4, 13-6, 13-7, 13-15 
CSRs 13-5 

data buffers 13-3, 13-4 
data chaining 13-27 
data structures 13-3 
descriptor entry 13-27 
descriptor rings 13-4 
Ethernet data stream 13-27 
initialization block 13-3, 13-18, 
13-27 
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base address 13-18 
mode 13-19 

logical address filter field 13-22 
logical address mask 13-4 
message descriptors 13-27 
mode of operation 13-4 
physical address field 13-19 
physical address mask 13-4 
polling 13-27 
programming 13-3 
programming sequence 13-4 
receive and transmit descriptor 
rings 13-3, 13-4, 13-28 
location of 13-4 
number of entries 13-4 
receive descriptor ring pointer 
field 13-23, 13-24 
receive descriptor rings 
receive message descriptor 1, 
rmdl 13-30, 13-27 
receive mode 13-3 
register address port 13-5, 13-7 
register data port 13-5, 13-6 
RMD2 13-32 
RMD3 13-33 
status register 13-3 
TMDO 13-34 
TMD1 13-35 
TMD2 13-37 
TMD3 13-38 
transmit 

descriptor ring pointer 13-25 
message descriptors 13-27 
mode 13-3 

LANCE - see Local Area Network 
Controller 13-2 
LANCE interrupt 15-149 
LAT 

/D switch 18-55 
/G switch 18-56 
/R switch 18-56 
call-back routine 18-58, 18-60 
closing a session 18-58 
command line 18-555 


custom application interface 17-66 
data exchange 18-58 
flow control 18-58 
functions 18-64 
close session 18-67 
get next service name 18-70 
get status 18-65 
open session 18-66 
read data 18-68 
send break signal 18-72 
send data 18-69 
service table reset 18-71 
overview 18-54 
program example 18-73 
service directory 18-56 
session control block 18-59 
session start 18-57 
session status word 18-63 
slots 18-57 

LAT control blocks 17-62 

LAT functions 
CloseLat 17-68 
GetLatService 17-71 
GetLatStatus 17-69 
InquireLatServices 17-70 
OpenLat 17-67 
ReadLat 17-68 
SendLatBreak 17-70 
WriteLat 17-69 

LAT support 17-62 

Latches, divisor 9-15 

LCB 17-62 

number available 17-62 

LCOUNTRY 16-27 
file structure 16-27 

LEDs 17-4 

automatic control 15-108 
color indications 14-8 
during powerup test 14-8 
I/O board 14-8 
memory board option 14-8 
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processor board 14-8 
supported 17-4 

LEDs on/off 

keyboard-interface controller com¬ 
mand codes 8-26 

Line 

control register 9-7 

LAT state change call-back 18-9 

status interrupt 9-10 

status register 9-11 

Listen for session 18-107 

LK250 keyboard 8-1, 17-2 
command codes 8-22 
control functions 8-3 
error handling 8-31 
key mappings 17-13 
layout 15-103 
logical interface 8-2 
pass-through mode 8-2 
physical interface 8-2 
programming example 8-46 
responses 8-30 
acknowledge 8-31 
buffer overrun 8-30 
echo 8-30 
release prefix 8-31 
resend 8-31 
self-test failure 8-31 
self-test success 8-30 
scan codes 8-15 

and industry-standard equivalent 
values 8-17 

translated but not used 8-21 
system powerup 8-2 
translate mode 8-2 
U.S. and foreign legends 8-31 

Loadable device drivers 
ANSI.SYS 16-5 

Loading font files 16-19 

Local area network controller 13-2 
(LANCE) interrupt 15-149 

Local Area Transport 


see LAT 18-54 

Loop services 18-42 

Loopbacks 

diagnostic 9-10 

M 

Main status register 11-4 

Maintenance operations protocol 
console server identify self 18-42 
loop services 18-42 
network boot request 18-43 
remote read counters 18-43 

Mapping 

asynch serial comm devices to 
LAT services 17-62 
character position 7-7 
input/output 2-4 
interrupt address 2-6 
memory 2-3 

Memory 

sizing 

and initializing 14-8 
during extended self-test 14-10 
without initializing 14-12 
use in real mode 14-8 
use in virtual protected mode 14-8 
three-channel counter and speaker 
6-3 

Memory map 
physical 2-3 

Messages 

illogical keyboard 17-12 

Mode register, 4-12 
1 10-10 
2 10-11 

Mode-dependent values 

set cursor type function 15-12 

Modem 

connector signals 9-21 
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control register 9-9 
programming exceptions 9-17 
status interrupt 9-10 
status register 9-13 

Monitor 

interface signals 7-44 
specifications 7-44 

MOP 18-42 

start and send system ID 18-45 
stop 18-45 

Mouse 10-1, 17-61 

asynchronous serial interface 10-2 
baud rates 10-2, 10-11 
button position 10-3 
commands (table) 10-2 
communication 10-2 
data bytes 10-2 
encoders 10-1 

extended self-test loopback test 
serial ports 14-10 
incremental stream mode com¬ 
mand 10-3 

invoke self-test command 10-3 
movement 10-3 
port interrupt 15-150 
position 10-3 

programming example 10-14 
prompt mode command 10-3 
reports 10-4 — 10-7 
request mouse position command 
10-3 

self-test 10-3 

serial interface 10-2, 10-8 
command register 10-12 
mode register 1 10-10 
mode register 2 10-11 
status register 10-9 
serial interface registers 10-8 
transmit holding register and 
receive buffer 10-8 
Signetics 

SCN2261 enhanced 
programmable communications 
interface 10-2, 10-8 


transmit holding register and re¬ 
ceive buffer 10-8 

vendor reserved function command 
10-3 

Mouse reports 

position (byte 1) 10-4 
position (byte 2) 10-5 
position (byte 3) 10-5 
self-test (byte 1) 10-6 
self-test (byte 2) 10-6, 10-7 
self-test (byte 3) 10-7 

Move a block of memory 15-93 
Movement 10-3 

MS-DOS Date and Time Structure 
16-3, 16-4 

MS-Network 

compatible session services 18-92 
session level interface 13-1 

MS-Windows 

applications programming inter¬ 
face 17-2 
entry points 

AnsiToOem 17-55 
OemToAnsi 17-58 

Mulicast address 
enable 18-21 
disable 18-22 
format 18-7 

Multiplex messages 18-6 
N 

Name status for session 18-103 
Network 

addressing 18-90 
boot request 18-36, 18-43 
hardware interface 13-1 
interconnect, CSR 13-17 

Network interface 13-2 
CSR 13-5 

external interconnect 13-40 
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physical I/O ports 13-5 
register description 13-5 
system bus interconnect 13-40 

Network software 18-1 
components 18-2 
datalink 18-5 
overview 18-2 

NI - see Network Interface 13-2 
NI CSR 13-40 

No return to user function 15-92 
Nonmaskable interrupt 15-3, 15-76 

Normal keyboard functions 

fetch next character input from 
keyboard 17-75 

return current shift status 17-76 
test for character available 17-75 

Not supported functions 
joystick support 15-91 

Numeric keypad 17-3 
Numlock 

toggling numeric keypad 17-3 
O 

OemToAnsi 17-58 
Open 

datalink portal 18-17 
device function 15-89 
LAT session 18-66 

OpenComm 17-63 
OpenLat 17-67 

Operational states 

diskette drive controller 11-18 

P 

Parallel 

bit stream, converted by LANCE 
13-3 


port retry function 15-131 

Parameters 
disk 16-14 

Pass-through mode 
keyboard 8-2 

Peripheral interrupt controller 
initializing 3-24 

Pointer 

diskette parameter tables 15-143 
graphics character table pointer 
15-145 

hard disk parameter tables 15-146 
video parameters 15-142 

Poll command 3-17 
Port driver 18-5 

Portal 

close 18-21 
defined 18-5 
read list 18-29 
read status 18-30 

Powerup test 14-1, 14-8 
LEDs 14-8 
RAM checks 14-8 
self-test error codes 14-8, 14-10 
sequence 14-1 

Print screen 15-4 
Printer 

connector signals 9-20 
extended self-test loopback test 
14-10 

GDI support 17-83 
output interrupt 15-123 
to Host mode C-12 
type function 15-129 

Priorities 

DMA controller 4-5 
rotation 3-13 

Processor board 
testing 14-14 

Processor modes 
real mode 14-8 
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virtual protected mode 14-8 
Programming 

diskette drive controller 11-18 

Programming examples 
counter and speaker 6-20 
datalink 18-46 

diskette drive controller 11-27 
DMA controller 4-15 
constant values 4-15 
data structures 4-17 
disabling DMA channel 4-22 
initializing 4-18 
opening DMA channel 4-19 
preparing DMA channel 4-20 
interrupt controllers 3-21 
LAT 18-73 

LK250 keyboard 8-46 

mouse 10-14 

real-time clock 5-15 

three-channel counter/timer 6-16 

UART (8250A) 9-22 

video controller 7-45 

modem control 9-17 

Prompt mode command 10-3 

Pulse output port command 

keyboard-interface controller 8-13 

R 

RAM 

system 

powerup test checks 14-8 
Rate generator 6-5 
Read 

channel status for datalink 18-27 
character and attribute at cursor 
position function 15-19 
command 8-10 
configuration interrupt 15-35 
current video state function 15-27 
cursor position function 15-14 


data command 11-21 
data for LAT 18-68 
datalink counters 18-32 
DECparm string address 18-39 
deleted data command 11-22 
id command 11-23 
light-pen position function 15-15 
long 256 byte sector 15-58 
long function 15-50 
node entry given index for session 
18-125 

node entry given node name for 
session 18-124 

node entry given node number for 
session 18-123 

one or more disk sectors function 
15-44 

one or more track sectors 15-63 
pixel function 15-24 
port 1 command 8-12 
port 2 command 8-13 
portal list for datalink 18-29 
portal status for datalink 18-30 
real-time clock function 15-137 
sector command 12-13 
system clock function 15-136 
test inputs command 8-13 
track command 11-23 
verify command 12-19 

Read-back command 

three-channel counter and speaker 
6-13 

ReadComm 17-64 

ReadLat 17-68 

Real mode 14-8 

Real-time clock 
address map 5-3 
addressing 5-2 
alarm registers 5-12 
automatic alarm cycles 5-12 
avoiding update cycles 5-13 
battery backup source 5-2 
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data register ranges 5-11 
data registers 5-10 
extended self-test 14-10 
features 5-1 
interrupts 5-14 
programming example 5-15 
register A 5-4 
register B 5-6 
register C 5-8 
register D 5-9 
registers 5-3 
update cycle 5-13 

Real-time clock interrupt 15-148 

Recalibrate command 
diskette drive controller 
register sets 11-26 

Recalibrate drive function 15-55 

Receive 

any for session 18-112 
broadcast for session 18-117 
buffer/transmitter holding register 
9-3 

character function 15-74 
datagram for session 18-115 
for datalink 18-10 
for session 18-111 
message descriptor, see RMD 
13-29 

Redirect 

parallel printer function 15-127 
to interrupt OAH interrupt 15-148 

Redirector 18-84 

Register sets 

format track command 11-24 
read data command 11-21 
read deleted data command 11-22 
read id command 11-23 
read track command 11-23 
recalibrate command 11-26 
scan equal command 11-24 
scan high or equal 11-25 
scan low or equal 11-25 


seek command 11-27 
sense drive status command 11-27 
sense interrupt status command 
11-26 

specify command 11-26 

write data command 11-21 

write deleted data command 11-22 

Registers 

8250A UART 9-2 
diskette drive controller 11-2 
C 11-15 
change 11-6 
control 11-3 
D 11-17 
data 11-5 

data transfer rate 11-6 
DTL 11-16 
EOT 11-16 
GPL 11-16 
H 11-15 

head/unit select 11-8 
hlt/nd 11-15 
internal 11-7 
main status 11-4 
N 11-16 
NCN 11-17 
PCN 11-17 
R 11-15 
SC 11-16 
srt/hut 11-14 
status register 0 11-9 
status register 1 11-10 
status register 2 11-12 
status register 3 11-13 
STP 11-17 
DMA controller 4-7 
base and current address 4-7 
base and current word 4-8 
command 4-9 
mode 4-12 
request 4-13 
status 4-14 
temporary 4-14 
interrupt enable 9-4 
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interrupt identification 9-6 
keyboard-interface command 8-9 
keyboard-interface controller 
command 8-5 
data 8-5 
status 8-6 
line control 9-7 
line status 9-11 
modem control 9-9 
modem status 9-13 
receive buffer/transmitter holding 
9-3 

special purpose 9-18 
three-channel counter and speaker 
6-8 

control 6-11 
system 6-9 
video controller 
color select 7-39 
control register A 7-41 
control register B 7-43 
status 7-37, 7-38 
write data 7-39 

Release prefix 

LK250 keyboard responses 8-31 

Remapping 
keyboard 16-19 

Remote read counters 18-43 

Repeating key 

changing focus 17-11 

Request 

line, DMA 13-40 

mouse position command 10-3 

register 4-13 

transmit buffer for datalink 18-25 

Request keyboard id 17-78 
function 15-118 

keyboard-interface controller com¬ 
mand codes 8-23 

Resend 

keyboard-interface controller com¬ 
mand codes 8-29 


LK250 keyboard responses 8-31 

Reserved 

keyboard-interface controller com¬ 
mand codes 8-25, 8-26, 8-29 

Reset 

for session 18-98 

keyboard-interface controller com¬ 
mand codes 8-29 
keyboard led 

keyboard-interface controller 
command codes 8-24 
mode function 16-11 
processor 14-13 

Restore command 12-11 

Restore to defaults 

keyboard-interface controller com¬ 
mand codes 8-28 

Result state 

diskette drive controller 11-20 

Retry on timeout error 15-86 

Return 

asynchronous port status function 
15-75 

change line status function 15-68 
current drive parameters function 
15-48 

current shift status flag 17-76 
days-since-read counter function 
15-140 

DIGITAL configuration word 
15-99 

drive type function 15-57, 15-67 
keyboard nationality 17-6 
memory size above one megabyte 
function 15-95 

memory size interrupt 15-37 
printer status function 15-126 
RTC date function 15-138 
status code of last I/O request 
15-62, 15-43 

Return codes 
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datalink 18-12 
session 18-93 

Revector of interrupt 13 H interrupt 
15-145 

RMDO 13-29 
ROM BIOS 

available (IRQ15) interrupt 15-151 
basic interrupt 15-132 
bootstrap interrupt 15-133 
clock tick interrupt 15-5 
COM 1/serial interrupt 15-6 
COM2/modem interrupt 15-6 
during soft reset 14-12 
firmware diagnostics and 14-8 
initialization procedure 14-12 
loading operating system 14-12 
local area network controller 
(LANCE) interrupt 15-149 
mouse port interrupt 15-150 
nonmaskable interrupt 15-3, 15-76 
print screen interrupt 15-4 
read configuration interrupt 15-35 
real-time clock interrupt 15-148 
redirect to interrupt OAH inter¬ 
rupt 15-148 

return memory size interrupt 
15-37 

revector of interrupt 13H interrupt 
15-145 

RTC alarm interrupt 15-148 
serial printer port interrupt 15-150 

ROM BIOS 80287 error interrupt 
15-151 

ROM BIOS asynchronous communi¬ 
cations interrupt 15-70 
extended mode 15-77 
initialize asynchronous port func¬ 
tion 15-72 

receive character 15-74 
retry on timeout error 15-86 
return asynchronous port status 
15-75 

send break 15-84 


set baud rate 15-87 
set modem control 15-85 
transmit character 15-73 

ROM BIOS cassette input/output in¬ 
terrupt 15-88 
begin virtual mode 15-96 
close device 15-89 
device is busy 15-98 
interrupt completion handler 15-98 
joystick support 15-91 
move a block of memory 15-93 
open device 15-89 
return DIGITAL configuration 
word 15-99 

return memory size above one 
megabyte 15-95 

service system request key 15-91 
set a wait interval 15-90 
termination 15-90 
wait (no return to user) 15-92 

ROM BIOS disk I/O interrupt 15-38 
diskette errors 15-59 
diskette functions 15-59 
diskette parameter tables 15-59 
execute controller internal diag¬ 
nostics 15-56 
format track 15-47, 15-66 
hard disk 
errors 15-40 
functions 15-40 
parameter tables 15-41 
reset function 15-53 
initialize 

diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
read long 256 byte sector 15-58 
read long 15-50 

read one or more disk sectors 15- 
44 

read one or more track sectors 15- 
63 

recalibrate drive 15-55 
return change line status 15-68 
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return current drive parameters 
15-48 

return drive type 15-57, 15-67 
return status code of last I/O 
request 15-43, 15-62 
seek to specific cylinder 15-52 
set drive and media type for 
format 15-69 
test drive ready 15-54 
verify one or more disk sectors 15' 
46 

verify one or more track sectors 
15-65 

write long 15-51 

write one or more disk sectors 15- 
45 

write one or more track sectors 
15-64 

ROM BIOS diskette 
errors 15-59 
functions 15-59 
parameter tables 15-59 
interrupt 15-143 

ROM BIOS floppy disk interrupt 
15-7 

ROM BIOS graphics character table 
pointer interrupt 15-145 

ROM BIOS hard disk 
interrupt 15-151 

parameter tables interrupt 15-146 

ROM BIOS initialization procedure 
14-12 

ROM BIOS interrupt 
02H 15-3, 15-76 
05H 15-4 
08H 15-5 
09H 15-5 
OBH 15-6 
OCH 15-6 
OEH 15-7 
11H 15-35 
12H 15-37 


18H 15-132 
19H 15-133 
1BH 15-141 
1CH 15-141 
1DH 15-142 
1EH 15-143 
40H 15-145 
41H 15-146 
46H 15-146 
4AH 15-148 
70H 15-148 
71H 15-148 
72H 15-149 
73H 15-150 
74H 15-150 
75H 15-151 
76H 15-151 
77H 15-151 

ROM BIOS Interrupt 10H 15-8 
enable/disable 256 character 
graphic font 15-30 
font RAM and color map support 
15-31 

read character and attribute at 
cursor position 15-19 
read current video state 15-27 
read cursor position 15-14 
read light-pen position 15-15 
read pixel 15-24 
scroll active page down 15-17 
scroll active page up 15-17 
set color palette 15-22 
set cursor position 15-13 
set cursor type 15-12 
set page 15-16 
set video mode 15-10 
TTY write string 15-28 
write character and attribute at 
cursor position 15-20 
write character at cursor position 
15-21 

write character using terminal 
emulation 15-25 
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write pixel 15-23 

ROM BIOS interrupt 13H 15-38 
diskette errors 15-59 
diskette functions 15-59 
diskette parameter tables 15-59 
execute controller internal diag¬ 
nostics 15-56 

format a track 15-47, 15-66 
hard disk 
errors 15-40 
functions 15-40 
parameter tables 15-41 
reset 15-53 
initialize 

diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
read long 256 byte sector 15-58 
read long 15-50 
read one or more disk sectors 
15-44 

read one or more track sectors 
15-63 

recalibrate drive 15-55 
return 

change line status 15-68 
current drive parameters 15-48 
drive type 15-57, 15-67 
status code of last I/O request 
15-43, 15-62 

seek to specific cylinder 15-52 
set drive and media type for 
format 15-69 
test drive ready 15-54 
verify one or more disk sectors 
15-46 

verify one or more track sectors 
15-65 

write long 15-51 
write one or more disk sectors 
15-45 

write one or more track sectors 
15-64 

ROM BIOS interrupt 14H 15-70 


extended mode 15-77 
initialize asynchronous port 15-72 
receive character 15-74 
retry on timeout error 15-86 
return asynchronous port status 
15-75 

send break 15-84 
set baud rate 15-87 
set modem control 15-85 
transmit character 15-73 

ROM BIOS interrupt 15H 15-88 
begin virtual mode 15-96 
close device 15-89 
device is busy 15-98 
interrupt completion handler 15-98 
joystick support 15-91 
move a block of memory 15-93 
open device 15-89 
return digital configuration word 
15-99 

return memory size above one 
megabyte 15-95 

service system request key 15-91 
set a wait interval 15-90 
termination 15-90 
wait (no return to user) 15-92 

ROM BIOS interrupt 16H 15-101 
character count 15-114 
extended codes and functions 
15-116 

key notification 15-111 
keyboard buffer 15-115 
keyboard input 15-109 
keyboard state 15-110 
keyboard status 15-109 
keyboard table pointers 15-120 
request keyboard ID 15-118 
send to keyboard 15-119 

ROM BIOS interrupt 17H 15-123 
initialize printer 15-125 
parallel port retry 15-131 
printer type 15-129 
redirect parallel printer 15-127 


Index 25 



return printer status 15-126 
transmit character 15-124 

ROM BIOS interrupt 1AH 15-135 
cancel alarm 15-140 
read real-time clock 15-137 
read system clock 15-136 
return 

days-since-read counter 15-140 
RTC date 15-138 
set alarm 15-139 
set real-time clock 15-138 
set RTC date 15-139 
set system clock 15-136 

ROM BIOS interrupt vectors 15-1, 
15-2 

ROM BIOS keyboard 
break interrupt 15-141 
input interrupt 15-101 
interrupt 15-5 

character count 15-114 
extended codes and functions 
15-116 

keyboard buffer 15-115 
keyboard input 15-109 
keyboard notification 15-111 
keyboard state 15-110 
keyboard status 15-109 
keyboard table pointers 15-120 
request keyboard ID 15-118 
send to keyboard 15-119 

ROM BIOS printer output interrupt 
15-123 

initialize printer 15-125 
parallel port retry 15-131 
printer type 15-129 
redirect parallel printer 15-127 
return printer status 15-126 
transmit character 15-124 

ROM BIOS time-of-day interrupt 
15-135 

cancel alarm 15-140 
read real-time clock 15-137 
read system clock 15-136 


return days-since-read counter 
15-140 

return rtc date 15-138 
set alarm 15-139 
set real-time clock 15-138 
set rtc date 15-139 
set system clock 15-136 

ROM BIOS timer tick interrupt 
15-141 

ROM BIOS video 
modes 15-10 

parameters interrupt 15-142 

ROM BIOS video input/output inter¬ 
rupt 15-8 

enable/disable 256 character 
graphic font 15-30 
font RAM and color map support 
15-31 

functions 15-9 

read character and attribute at 
cursor position 15-19 
read current video state 15-27 
read cursor position 15-14 
read light-pen position 15-15 
read pixel 15-24 
scroll active page down 15-17 
scroll active page up 15-17 
set color palette 15-22 
set cursor position 15-13 
set cursor type 15-12 
set page 15-16 
set video mode 15-10 
tty write string 15-28 
write character and attribute at 
cursor position 15-20 
write character at position 15-21 
write character using terminal 
emulation 15-25 
write pixel 15-23 

ROM diagnostics 14-1. 14-8 
extended self-test 14-10 
powerup test 14-1, 14-8 

Rotating priority 
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DMA controller 4-5 
RTC alarm interrupt 15-148 

S 

Scan codes 15-102 

LK250 keyboard 8-15, 8-17 
translated but not used 8-21 

Scan equal command 
diskette drive controller 
register sets 11-24 

Scan high or equal command 
diskette drive controller 
register sets 11-25 

Scan low or equal command 
diskette drive controller 
register sets 11-25 

Scroll active page down function 15- 
17 

Scroll active page up function 15-17 

SDH register 12-9 

Sector 

count register 12-7 
interleave 12-18 
number register 12-7 

Seek command 12-12 
diskette drive controller 
register sets 11-27 

Seek to specific cylinder 15-52 
Select 

compose processing 17-6 
numlock processing 17-6 

Self-test command 

keyboard-interface controller 8-12 

Self-test failure 

LK250 keyboard responses 8-31 

Self-test success 

LK250 keyboard responses 8-30 

Send 


break signal for LAT 18-72 
broadcast for session 18-116 
data for LAT 18-69 
datagram for session 18-114 
double for session 18-110 
for session 18-109 

Send break function 15-84 
Send to keyboard function 15-119 
SendLatBreak 17-70 
Sense 

drive status 11-27 
interrupt status 11-26 

Serial 
data 9-1 

printer port interrupt 15-150 
bit stream, converted by LANCE 
13-3 

interface adapter 13-2, 13-3 
Server message block 18-127 
Service 

directory 18-56 

table reset for LAT 18-71 

system request key function 15-91 

Session 

start for LAT 18-57 
status word 18-63 
for LAT 18-57 

asynchronous notification routine 
18-90 

asynchronous requests 18-89 
functions 18-91 
add a node 18-120 
add name 18-101 
call 18-105 
cancel 18-97 

check for presence 18-96 
delete all node entries 18-126 
delete entry given node name 
18-122 

delete entry given node number 
18-121 

delete name 18-102 
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DIGITAL function check 18-119 

DIGITAL-specific 18-118 

hangup 18-108 

listen 18-107 

name status 18-103 

read node entry given index 

18-125 

read node entry given node 
name 18-124 

read node entry given node 
number 18-123 
receive 18-111 
receive any 18-112 
receive broadcast 18-117 
receive datagram 18-115 
reset 18-98 
send 18-109 
send broadcast 18-116 
send datagram 18-114 
send double 18-110 
status 18-99 

MS-Network compatible services 
18-92 

network addressing 18-90 
overview 18-83 
return codes 18-93 
status buffer 18-100 
synchronous requests 18-89 

Session control block (SCB) 18-85 
fields 18-86 
for LAT 18-59 

Set 

a wait interval function 15-90 
alarm function 15-139 
autorepeat delay and rate 8-27 
baud rate function 15-87 
color palette function 15-22 
country code function 16-3 
cursor position function 15-13 
cursor type function 

Mode-dependent values 15-12 
DECparm string address 18-40 
drive and media type for format 
function 15-69 


graphics rendition function 16-8 
keyboard led 8-23 
keyclick volume 8-24 
mode function 16-10 
modem control function 15-85 
page function 15-16 
parameters command 12-22 
real-time clock function 15-138 
RTC date function 15-139 
system clock function 15-136 
video mode function 15-10 

SetCommBreak 17-65 
SetCommEventMask 17-65 
SetCommState 17-65 
Shift key 

affect on numeric keypad 17-3 

SIA - See Serial Interface Adapter 
13-2 

Signals 

communications connector 9-19 
modem connector 9-21 
printer connector 9-20 

Signetics 

SCN2261 enhanced programmable 
communications interface 10-2, 
10-8 

Single transfer mode 
DMA controller 4-3 

Slots for LAT 18-57 
SMB 

get current date and time 18-128 
overview 18-127 

Soft reset 14-12 

Software interrupts 

asynchronous communictaions 
15-70 

basic 15-132 
bootstrap 15-133 
cassette input/output 15-88 
disk input/output (i/o) 15-38 
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keyboard break 15-141 
keyboard input 15-101 
print screen 15-4 
printer output 15-123 
read configuration 15-35 
return memory size 15-37 
revector of interrupt 13h 15-145 
RTC alarm 15-148 
time-of-day 15-135 
timer tick 15-141 
video input/output 15-8 

Software triggered strobe 

three-channel counter and speaker 
6-6 

SORT 16-30 

Sort tables 16-32 
creating 16-30 

SORT.EXE 

how affected by FONT.COM 16-16 

Sorting 

format 16-30 

Special purpose register 7-23, 9-18 

Specify command 

diskette drive controller 
register sets 11-26 

Speed 

indicator control signal 9-17 
select control signal 9-17 

Square wave model 

three-channel counter and speaker 
mode 6-5 

Standard applications support 17-74 
temporarily suspending 17-79 

Standard communication of the 
VAXmate workstation 13-2 

Startup 

diagnostics 14-1, 14-8 
diagnostics test modes 14-1 

Status 

buffer for session 18-100 


for session 18-99 

Status register 4-14, 7-3, 10-9, 12-23 
A 7-37 
B 7-38 

keyboard-interface controller 8-6 
Status response 

three-channel counter and speaker 
6-14 

STDUS.KEY 16-25 
changing to 16-25 

Subroutines 

assembly language A-l 

Synchronous requests 18-89 

SYSREQ 17-5 

System 

bus 13-2, 13-40 
configuration list 

during extended self-test 14-10 
newly installed options 14-10 
powerup 8-4 

RAM powerup test checks 14-8 
register 6-9 

T 

Temporary register 4-14 

Terminal emulation 
font size 17-73 

Termination function 15-90 
Test 

drive ready function 15-54 
for character available 17-75 
reports for mouse self-test 10-3 

Text modes 7-6 
cursor rate 7-8 
cursor size 7-8 

ThinWire 

Ethernet 13-3 
interconnect 13-3 
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network interface 13-4 

Three-channel counter and speaker 
control word register 6-11 
counter and speaker example 6-20 
counter-latch command 6-12 
mode 0 6-4 
mode 1 6-4 
mode 2 6-5 
mode 3 6-5 
mode 4 6-6 
mode 5 6-7 
mode definitions 6-3 
modes of operation 6-3 
programming example 6-16 
read-back command 6-13 
status response 6-14 
system register 6-9 

Time-of-Day interrupt 15-135 

Timer tick interrupt 15-141 

Toggling keyboard mode 17-4 

Translate mode 
keyboard 8-2 

TranslateMessage 17-4 

Translating 

attribute data 7-18 
graphic color data 7-18 
the keyboard 15-121 

Transmit 

character function 15-73, 15-124 
for datalink 18-10, 18-23 
holding register and receive buffer 
10-8 

descriptor ring pointer 13-26 

TransmitCommChar 17-64 

Transport error codes 18-95 

TTY write string function 15-28 

U 

UART (8250A| registers 9-2 


programming example 9-22 

Universal asynchronous receiver/ 
transmitters (8250A UART) 9-1 

User call-back routines for datalink 
18-8 


VAXmate 

address decode logic 13-5 
diagnostics 13-4 
expansion box 13-40 
I/O board 13-1 
I/O bus 13-5 
I/O functions 13-2 
memory option 13-40 
network software 18-1 
video display memory 13-40 
workstation 

base configuration 1-1 
optional components 1-2 

Verify 

one or more disk sectors function 
15-46 

one or more track sectors 15-65 
Video 

input/output interrupt 15-8, 15-9 
modes for the ROM BIOS 15-10 
parameters interrupt 15-142 

Video controller 

color select register 7-39 
control register A 7-41 
control register B 7-43 
enhancements to industry-standard 
features 7-2 
graphic features 7-2 
industry-standard features 7-1 
programming example 7-45 
status register A 7-37 
status register B 7-38 
text modes 7-6 

unavailable industry-standard fea- 
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tures 7-2 
video modes 7-5 
write data register 7-39 

Video memory 7-3 

Video modes 7-5 

handling inside a window 17-79 
no ROM BIOS 

DIGITAL-extended 7-12, 7-14 
ROM BIOS 

industry-standard 7-11, 7-13 
ROM BIOS 

DIGITAL-extended 7-15, 7-16, 
7-17 

Video processor 

input/output registers 7-22 
look-up table 7-18 

Virtual protected mode 14-8 

VT220 

additional emulator escape se¬ 
quences C-6 
announcing C-8 
character set differences C-5 
communications differences C-3 
DA C-8 

DECAUPSS C-6 
DECRQUPSS C-6 
differences between emulator and 
terminal C-2 
keyboard differences C-4 
printing C-9 
SCS C-6, C-7 
video differences C-2 

VT240 

additional emulator escape se¬ 
quences C-13 
announcing C-16 
character set differences C-13 
communications differences C-12 
DA C-15, C-16 
DECAUPSS C-13 
DECRQUPSS C-14 
difference between emulator and 
terminal C-10 


keyboard differences C-12 
Printer to Host mode C-12 
SCS C-14, C-15 
video differences C-10 


W 

Windows 

keyboard extensions 17-5 
layer 17-2 
reserved keys 17-5 

Write 

all mask bits 4-11 
character and attribute at cursor 
position 15-20 

character at cursor position 15-21 
character using terminal emulation 
15-25 
long 15-51 

one or more track sectors 15-64 
one or more disk sectors 15-45 
pixel 15-23 

Write command 

keyboard-interface controller 8-10 

Write data command 

diskette drive controller register 
sets 11-21 

Write data register 7-39 

Write deleted data command 
diskette drive controller register 
sets 11-22 

Write port 2 command 

keyboard-interface controller 8-13 

Write precompensation register 12-4 
sector command 12-15 
single mask bit 4-11 
status register command keyboard- 
interface controller 8-13 

WriteComm 17-63 
WriteLat 17-69 
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